{"slug":"addyosmani-code-review-and-quality","name":"code-review-and-quality","description":"Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.","long_description":"---\nname: code-review-and-quality\ndescription: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.\n---\n\n# Code Review and Quality\n\n## Overview\n\nMulti-dimensional code review with quality gates. Every change gets reviewed before merge — no exceptions. Review covers five axes: correctness, readability, architecture, security, and performance.\n\n**The approval standard:** Approve a change when it definitely improves overall code health, even if it isn't perfect. Perfect code doesn't exist — the goal is continuous improvement. Don't block a change because it isn't exactly how you would have written it. If it improves the codebase and follows the project's conventions, approve it.\n\n## When to Use\n\n- Before merging any PR or change\n- After completing a feature implementation\n- When another agent or model produced code you need to evaluate\n- When refactoring existing code\n- After any bug fix (review both the fix and the regression test)\n\n## The Five-Axis Review\n\nEvery review evaluates code across these dimensions:\n\n### 1. Correctness\n\nDoes the code do what it claims to do?\n\n- Does it match the spec or task requirements?\n- Are edge cases handled (null, empty, boundary values)?\n- Are error paths handled (not just the happy path)?\n- Does it pass all tests? Are the tests actually testing the right things?\n- Are there off-by-one errors, race conditions, or state inconsistencies?\n\n### 2. Readability & Simplicity\n\nCan another engineer (or agent) understand this code without the author explaining it?\n\n- Are names descriptive and consistent with project conventions? (No `temp`, `data`, `result` without context)\n- Is the control flow straightforward (avoid nested ternaries, deep callbacks)?\n- Is the code organized logically (related code grouped, clear module boundaries)?\n- Are there any \"clever\" tricks that should be simplified?\n- **Could this be done in fewer lines?** (1000 lines where 100 suffice is a failure)\n- **Are abstractions earning their complexity?** (Don't generalize until the third use case)\n- Would comments help clarify non-obvious intent? (But don't comment obvious code.)\n- Are there dead code artifacts: no-op variables (`_unused`), backwards-compat shims, or `// removed` comments?\n- **Is a new conditional bolted onto an unrelated flow?** That's a design smell, not a nit — push the logic into its own helper, state, or policy instead of tangling an existing path.\n- **Do repeated conditionals on the same shape appear?** They signal a missing model or dispatcher. A \"temporary\" branch is usually permanent debt.\n\n### 3. Architecture\n\nDoes the change fit the system's design?\n\n- Does it follow existing patterns or introduce a new one? If new, is it justified?\n- Does it maintain clean module boundaries?\n- Is there code duplication that should be shared?\n- Are dependencies flowing in the right direction (no circular dependencies)?\n- Is the abstraction level appropriate (not over-engineered, not too coupled)?\n- **Does this refactor reduce complexity or just relocate it?** Count the concepts a reader must hold to follow the change. If a \"cleaner\" version leaves that count unchanged, it isn't cleaner — prefer the restructuring that makes whole branches, modes, or layers disappear over one that re-centralizes the same logic. Prefer deleting an abstraction to polishing it.\n- **Is feature-specific logic leaking into a shared or general-purpose module?** Keep logic in its owning layer, reuse the existing canonical helper instead of a near-duplicate, and don't normalize architectural drift.\n- **Are type boundaries explicit?** Question gratuitous `any`/`unknown`/optional/casts and silent fallbacks that paper over an unclear invariant — making the boundary explicit often makes the surrounding control flow simpler.\n\n### 4. Security\n\nFor detailed security guidance, see `security-and-hardening`. Does the change introduce vulnerabilities?\n\n- Is user input validated and sanitized?\n- Are secrets kept out of code, logs, and version control?\n- Is authentication/authorization checked where needed?\n- Are SQL queries parameterized (no string concatenation)?\n- Are outputs encoded to prevent XSS?\n- Are dependencies from trusted sources with no known vulnerabilities?\n- Is data from external sources (APIs, logs, user content, config files) treated as untrusted?\n- Are external data flows validated at system boundaries before use in logic or rendering?\n\n### 5. Performance\n\nFor detailed profiling and optimization, see `performance-optimization`. Does the change introduce performance problems?\n\n- Any N+1 query patterns?\n- Any unbounded loops or unconstrained data fetching?\n- Any synchronous operations that should be async?\n- Any unnecessary re-renders in UI components?\n- Any missing pagination on list endpoints?\n- Any large objects created in hot paths?\n\n## Structural Remedies\n\nWhen you flag a structural problem, propose the move — not just the problem. A review that only says \"this is complex\" leaves the author guessing. Reach for a named restructuring:\n\n- **Replace a chain of conditionals** with a typed model or an explicit dispatcher.\n- **Collapse duplicate branches** into a single clearer flow.\n- **Separate orchestration from business logic** so each reads on its own.\n- **Move feature-specific logic** out of a shared module into the package that owns the concept.\n- **Reuse the canonical helper** instead of a bespoke near-duplicate.\n- **Make a type boundary explicit** so downstream branching disappears.\n- **Delete a pass-through wrapper** that adds indirection without clarifying the API.\n- **Extract a helper, or split a large file** into focused modules.\n\nPrefer the remedy that removes moving pieces over one that spreads the same complexity around.\n\n## Change Sizing\n\nSmall, focused changes are easier to review, faster to merge, and safer to deploy. Target these sizes:\n\n```\n~100 lines changed   → Good. Reviewable in one sitting.\n~300 lines changed   → Acceptable if it's a single logical change.\n~1000 lines changed  → Too large. Split it.\n```\n\n**Watch file size, not just diff size.** A small diff can still push a file past a healthy boundary — around 1000 *total* lines in a single file (distinct from the ~1000 *changed*-lines threshold above) is a common inspection signal, not a hard cap. When a change materially grows an already-large file, ask whether to extract helpers, subcomponents, or modules *first*, before piling more on. Decompose, then add.\n\n**What counts as \"one change\":** A single self-contained modification that addresses one thing, includes related tests, and keeps the system functional after submission. One part of a feature — not the whole feature.\n\n**Splitting strategies when a change is too large:**\n\n| Strategy | How | When |\n|----------|-----|------|\n| **Stack** | Submit a small change, start the next one based on it | Sequential dependencies |\n| **By file group** | Separate changes for groups needing different reviewers | Cross-cutting concerns |\n| **Horizontal** | Create shared code/stubs first, then consumers | Layered architecture |\n| **Vertical** | Break into smaller full-stack slices of the feature | Feature work |\n\n**When large changes are acceptable:** Complete file deletions and automated refactoring where the reviewer only needs to verify intent, not every line.\n\n**Separate refactoring from feature work.** A change that refactors existing code and adds new behavior is two changes — submit them separately. Small cleanups (variable renaming) can be included at reviewer discretion.\n\n## Change Descriptions\n\nEvery change needs a description that stands alone in version control history.\n\n**First line:** Short, imperative, standalone. \"Delete the FizzBuzz RPC\" not \"Deleting the FizzBuzz RPC.\" Must be informative enough that someone searching history can understand the change without reading the diff.\n\n**Body:** What is changing and why. Include context, decisions, and reasoning not visible in the code itself. Link to bug numbers, benchmark results, or design docs where relevant. Acknowledge approach shortcomings when they exist.\n\n**Anti-patterns:** \"Fix bug,\" \"Fix build,\" \"Add patch,\" \"Moving code from A to B,\" \"Phase 1,\" \"Add convenience functions.\"\n\n## Review Process\n\n### Step 1: Understand the Context\n\nBefore looking at code, understand the intent:\n\n```\n- What is this change trying to accomplish?\n- What spec or task does it implement?\n- What is the expected behavior change?\n```\n\n### Step 2: Review the Tests First\n\nTests reveal intent and coverage:\n\n```\n- Do tests exist for the change?\n- Do they test behavior (not implementation details)?\n- Are edge cases covered?\n- Do tests have descriptive names?\n- Would the tests catch a regression if the code changed?\n```\n\n### Step 3: Review the Implementation\n\nWalk through the code with the five axes in mind:\n\n```\nFor each file changed:\n1. Correctness: Does this code do what the test says it should?\n2. Readability: Can I understand this without help?\n3. Architecture: Does this fit the system?\n4. Security: Any vulnerabilities?\n5. Performance: Any bottlenecks?\n```\n\n### Step 4: Categorize Findings\n\nLabel every comment with its severity so the author knows what's required vs optional:\n\n| Prefix | Meaning | Author Action |\n|--------|---------|---------------|\n| *(no prefix)* | Required change | Must address before merge |\n| **Critical:** | Blocks merge | Security vulnerability, data loss, broken functionality |\n| **Nit:** | Minor, optional | Author may ignore — formatting, style preferences |\n| **Optional:** / **Consider:** | Suggestion | Worth considering but not required |\n| **FYI** | Informational only | No action needed — context for future reference |\n\nThis prevents authors from treating all feedback as mandatory and wasting time on optional suggestions.\n\n**Lead with what matters.** Order findings by leverage: correctness and security first, then structural regressions and missed simplifications, then everything else. Don't bury a real issue under cosmetic nits — a few high-conviction comments beat a long list. If you have one structural problem and ten nits, the structural problem *is* the review.\n\n### Step 5: Verify the Verification\n\nCheck the author's verification story:\n\n```\n- What tests were run?\n- Did the build pass?\n- Was the change tested manually?\n- Are there screenshots for UI changes?\n- Is there a before/after comparison?\n```\n\n## Multi-Model Review Pattern\n\nUse different models for different review perspectives:\n\n```\nModel A writes the code\n    │\n    ▼\nModel B reviews for correctness and architecture\n    │\n    ▼\nModel A addresses the feedback\n    │\n    ▼\nHuman makes the final call\n```\n\nThis catches issues that a single model might miss — different models have different blind spots.\n\n**Example prompt for a review agent:**\n```\nReview this code change for correctness, security, and adherence to\nour project conventions. The spec says [X]. The change should [Y].\nFlag any issues as Critical, Required, Optional, or Nit.\n```\n\n## Dead Code Hygiene\n\nAfter any refactoring or implementation change, check for orphaned code:\n\n1. Identify code that is now unreachable or unused\n2. List it explicitly\n3. **Ask before deleting:** \"Should I remove these now-unused elements: [list]?\"\n\nDon't leave dead code lying around — it confuses future readers and agents. But don't silently delete things you're not sure about. When in doubt, ask.\n\n```\nDEAD CODE IDENTIFIED:\n- formatLegacyDate() in src/utils/date.ts — replaced by formatDate()\n- OldTaskCard component in src/components/ — replaced by TaskCard\n- LEGACY_API_URL constant in src/config.ts — no remaining references\n→ Safe to remove these?\n```\n\n## Review Speed\n\nSlow reviews block entire teams. The cost of context-switching to review is less than the waiting cost imposed on others.\n\n- **Respond within one business day** — this is t","tagline":"Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.","category":"coding-agents","tags":["agent-skill"],"author":"addyosmani","verified":false,"attribution":{"status":"registry_indexed","statusLabel":"Registry indexed","shortLabel":"REGISTRY INDEXED","sourceLabel":"recursive skill source sync","sourceDetail":"addyosmani/agent-skills","creatorName":"addyosmani","creatorUrl":"https://github.com/addyosmani","sourceUrl":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","indexedBy":"OpenAgentSkill community index","claimUrl":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality#claim-this-skill","claimCta":"Claim this skill","trustNote":"This listing was indexed from public sources and is not marked official until a maintainer claim is approved.","publicNote":"Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals."},"stats":{"stars":90428,"forks":9671,"verified_installs":0,"successful_runs":0,"total_outcomes":0,"rating":0,"review_count":0,"quality_score":57.64},"quality":{"score":95,"tier":"excellent","label":"Excellent","summary":"High-confidence pick with strong adoption and healthy maintenance signals.","signals":[{"label":"GitHub stars","value":"90K","tone":"positive"},{"label":"Freshness","value":"8d ago","tone":"positive"},{"label":"Install ready","value":"Yes","tone":"positive"},{"label":"License","value":"MIT","tone":"neutral"}],"warnings":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results."]},"trust":{"version":"trust-score-v5","score":68,"base_score":76,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["68/100 Trust Score v5","76/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"90K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"90K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"5 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"90K GitHub stars","repoActivity":"90K stars, 9.7K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["coding-agents","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","trust_score":68,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":76,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v5":{"version":"trust-score-v5","score":68,"base_score":76,"outcome_confidence":0,"tier":"review","label":"Sandbox only","summary":"Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.","recommendedAction":"Run only in a sandbox and compare close alternatives before using it for real work.","decision":{"install_policy":"human_review_before_install","auto_install_allowed":false,"human_review_required":true,"sandbox_first":true,"agent_action":"Compare alternatives before installing.","reasoning":["68/100 Trust Score v5","76/100 Trust Score v4 baseline","Needs more real agent outcomes before unattended install","Install path is available","Review before production"],"review_required_when":["The workspace contains production secrets, payments, private customer data, or irreversible actions.","The install command requests shell, network, credential, database, or broad filesystem access.","Outcome evidence is missing, recently failed, or required human review.","Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"]},"dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"90K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"90K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"5 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern","Outcome loop is ready but needs first real agent run"],"warnings":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access","No real agent outcome reports yet","Human review required before unattended installation"],"evidence":{"stars":"90K GitHub stars","repoActivity":"90K stars, 9.7K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet","agentProvenScore":0,"outcomeConfidence":"0%","installPolicy":"human_review_before_install"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push","Trust Score v5 requires review or sandbox-only use before install."]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Compare alternatives before installing."},"outcome_loop":{"version":"openagentskill-agent-outcome-v4","required_after_install":true,"endpoint":"/api/agent/outcome","method":"POST","event_id_source":"feedback.event_id, install_receipt.resolve_event_id, or decision_packet.outcome_feedback.event_id","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"required_fields":["event_id","skill_slug","task"],"quality_fields":["task_success","output_quality","error_type","human_review_required","used_in_production","workspace","evidence_url","time_to_useful_ms","source_version"],"ranking_inputs_updated":["Trust Score v5 outcome confidence","Agent Proven Score","Resolve ranking task-fit evidence","Skill detail machine-readable metadata","Outcome leaderboard"]},"agent_contract":{"suited_tasks":["coding-agents","agent-skill"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"install_command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","trust_score":68,"trust_version":"trust-score-v5","risk_level":"medium","do_not_use_when":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"before_install":["Read the audit page and machine-readable metadata.","Confirm the install command, license, and permission surface fit the workspace.","Get explicit human approval or choose an alternative before installing."],"after_run":["Report the outcome to /api/agent/outcome using the resolve event id.","Include output_quality, workspace, human_review_required, and evidence_url when available.","Re-resolve before broad production rollout."]},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"backward_compatible":{"trust_score_v4":{"version":"trust-score-v4","score":76,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout."}}},"trust_score_v4":{"version":"trust-score-v4","score":76,"tier":"strong","label":"Strong shortlist","summary":"Good trust signals with a few areas worth checking before rollout.","recommendedAction":"Test in a sandbox workflow and compare its install path with close alternatives.","dimensions":[{"id":"github_adoption","label":"GitHub adoption","score":100,"weight":0.13,"status":"pass","detail":"90K GitHub stars"},{"id":"repo_activity","label":"Stars/forks activity","score":100,"weight":0.08,"status":"pass","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"id":"maintenance","label":"Recent maintenance","score":100,"weight":0.14,"status":"pass","detail":"8d since push"},{"id":"license","label":"License clarity","score":86,"weight":0.09,"status":"pass","detail":"MIT"},{"id":"documentation","label":"README/SKILL.md completeness","score":86,"weight":0.14,"status":"pass","detail":"Metadata includes enough usage and workflow context"},{"id":"dependency_risk","label":"Dependency/runtime risk","score":74,"weight":0.12,"status":"info","detail":"network or browser surface, database surface"},{"id":"installability","label":"Install availability","score":92,"weight":0.1,"status":"pass","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"id":"install_safety","label":"Install command safety","score":92,"weight":0.1,"status":"pass","detail":"standard package or runtime install path"},{"id":"permission_surface","label":"Permission surface","score":60,"weight":0.07,"status":"warn","detail":"filesystem or document access, network or browser access"},{"id":"repository","label":"Repository evidence","score":86,"weight":0.04,"status":"pass","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"id":"review_status","label":"Review status","score":66,"weight":0.05,"status":"info","detail":"AI review data available"},{"id":"agent_outcomes","label":"Agent Proven outcomes","score":54,"weight":0.13,"status":"info","detail":"No agent outcome data yet"}],"checks":[{"status":"pass","label":"GitHub adoption","detail":"90K GitHub stars"},{"status":"pass","label":"Stars/forks activity","detail":"90K stars, 9.7K forks; issue activity unavailable in current metadata"},{"status":"pass","label":"Recent maintenance","detail":"8d since push"},{"status":"pass","label":"License clarity","detail":"MIT"},{"status":"pass","label":"README/SKILL.md completeness","detail":"Metadata includes enough usage and workflow context"},{"status":"info","label":"Dependency/runtime risk","detail":"network or browser surface, database surface"},{"status":"pass","label":"Install availability","detail":"npx skills add addyosmani/agent-skills --skill code-review-and-quality"},{"status":"pass","label":"Install command safety","detail":"standard package or runtime install path"},{"status":"warn","label":"Permission surface","detail":"filesystem or document access, network or browser access"},{"status":"pass","label":"Repository evidence","detail":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality"},{"status":"info","label":"Review status","detail":"AI review data available"},{"status":"info","label":"Agent Proven outcomes","detail":"No agent outcome data yet"},{"status":"warn","label":"Ownership","detail":"No approved owner claim yet"},{"status":"pass","label":"OpenAgentSkill usage","detail":"5 views, 0 install copies"},{"status":"info","label":"Agent outcomes","detail":"No agent outcome data yet"}],"strengths":["AI review approved","Install path is available","Repository evidence is available","Recently maintained repository","Large GitHub adoption signal","Install command has no obvious high-risk pattern"],"warnings":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"],"evidence":{"stars":"90K GitHub stars","repoActivity":"90K stars, 9.7K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"installReadiness":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","policy":"human_review_before_install","label":"Human review before install","notes":["Install path is available","Repository evidence is available","License is declared","No Agent Proven outcome evidence yet","8d since push"]},"agentCompatibility":["Codex","Claude Code","Cursor","OpenAgentSkill CLI"],"riskSummary":{"level":"medium","label":"Review before production","notes":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"outcomeEvidence":{"total":0,"successes":0,"failures":0,"notRelevant":0,"successRate":null,"installAttempts":0,"riskBlocked":0,"setupRequired":0,"installSuccessRate":null,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"recentSuccessRate":null,"recentFailureRate":null,"uniqueAgents":0,"agentProvenScore":0,"agentProvenLabel":"Needs first agent run","lastOutcomeAt":null,"label":"No agent outcome data yet"},"autoInstall":{"allowed":false,"sandboxRequired":true,"policy":"human_review_before_install","reason":"Human review or sandbox validation is required before automatic installation."},"bestFor":["coding-agents","agent-skill"],"doNotUseFor":["Production credentials, payments, or irreversible account changes without explicit human review","Sensitive private data before reviewing repository code, license, and permission surface","Automatic installation in a production workspace"],"knownRisks":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"outcome_stats":null,"safety":{"score":67,"level":"review_before_install","label":"Review before install","safety_tier":{"tier":"reviewed","label":"Reviewed with permission notes","badge":"REVIEWED","summary":"Usable candidate, but the agent should surface permission and audit notes before installation.","recommended_action":"Require human approval before installing into a real workspace.","auto_install_policy":"review","reasons":["Permission surface may require sandboxing","67/100 agent safety score"]},"auto_install_allowed":false,"human_review_required":true,"blocked":false,"audit_risk":"needs_review","permission_hints":[{"id":"network","label":"Network access","reason":"Skill likely fetches remote pages, APIs, repositories, or external services.","severity":"medium"},{"id":"filesystem","label":"Filesystem access","reason":"Skill may read or write project files, documents, generated artifacts, or local workspace state.","severity":"medium"},{"id":"database","label":"Database access","reason":"Skill may inspect schemas, query databases, or work with persistent stores.","severity":"medium"}],"policy_warnings":["Permission surface may require sandboxing"],"constraints_applied":{"max_risk":"medium","needs_install_command":true,"min_stars":0}},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","badge":"REVIEWED","auto_install_policy":"review","auto_install_allowed":false,"blocked":false,"human_review_required":true,"recommended_action":"Require human approval before installing into a real workspace.","reasons":["Permission surface may require sandboxing","67/100 agent safety score"]},"eval":{"version":"openagentskill-skill-eval-v1","status":"review","score":83,"risk_level":"medium","decision":{"recommendation":"manual_review","reason":"Require human approval before installing into a real workspace.","auto_install_allowed":false,"policy":"review","human_review_required":true},"blockers":[],"warnings":["Trust score: Good trust signals with a few areas worth checking before rollout.","Audit score: Needs review","Agent safety gate: Usable candidate, but the agent should surface permission and audit notes before installation.","Permission surface: filesystem or document access, network or browser access","Permission surface may require sandboxing","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access"],"validation_plan":["Inspect repository, README/SKILL.md, license, and recent commits before production use.","Install in an isolated workspace or sandbox with no production secrets available.","Run the smallest representative task and record files touched, commands run, network access, and outputs.","Compare the selected skill against at least one alternative when the eval status is review or failed.","Promote only after the agent reports a successful verification result and unresolved warnings are accepted."],"checks":[{"id":"task_fit","label":"Task fit","status":"pass","score":94,"required_for_auto_install":true,"detail":"Task wording matches this skill metadata.","evidence":["Evaluate code-review-and-quality before installing it in an agent workflow","coding-agents","Coding agents workflows; Claude Code teams; teams that value GitHub adoption signals"]},{"id":"install_path","label":"Install path","status":"pass","score":92,"required_for_auto_install":true,"detail":"Install handoff is available.","evidence":["npx skills add addyosmani/agent-skills --skill code-review-and-quality"]},{"id":"install_safety","label":"Install command safety","status":"pass","score":92,"required_for_auto_install":true,"detail":"standard package or runtime install path","evidence":["npx skills add addyosmani/agent-skills --skill code-review-and-quality"]},{"id":"trust_score","label":"Trust score","status":"warn","score":76,"required_for_auto_install":true,"detail":"Good trust signals with a few areas worth checking before rollout.","evidence":["Strong shortlist","90K GitHub stars","MIT"]},{"id":"audit_score","label":"Audit score","status":"warn","score":87,"required_for_auto_install":true,"detail":"Needs review","evidence":["Permission surface may require sandboxing"]},{"id":"agent_safety_gate","label":"Agent safety gate","status":"warn","score":67,"required_for_auto_install":true,"detail":"Usable candidate, but the agent should surface permission and audit notes before installation.","evidence":["Require human approval before installing into a real workspace.","Permission surface may require sandboxing"]},{"id":"readme_skillmd_completeness","label":"README/SKILL.md completeness","status":"pass","score":86,"required_for_auto_install":false,"detail":"Metadata includes enough usage and workflow context","evidence":["Strong README/SKILL.md context"]},{"id":"license_clarity","label":"License clarity","status":"pass","score":86,"required_for_auto_install":true,"detail":"MIT","evidence":["MIT"]},{"id":"recent_maintenance","label":"Recent maintenance","status":"pass","score":100,"required_for_auto_install":false,"detail":"8d since push","evidence":["8d since push"]},{"id":"permission_surface","label":"Permission surface","status":"warn","score":60,"required_for_auto_install":true,"detail":"filesystem or document access, network or browser access","evidence":["Network access: medium","Filesystem access: medium","Database access: medium"]},{"id":"alternatives","label":"Alternatives available","status":"info","score":55,"required_for_auto_install":false,"detail":"No close alternatives were found in the current shortlist.","evidence":[]}],"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality/evals","api":"/api/agent/evals?slug=addyosmani-code-review-and-quality","text":"/api/agent/evals?slug=addyosmani-code-review-and-quality&format=text"}},"agent_readable_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"addyosmani-code-review-and-quality","name":"code-review-and-quality","description":"Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.","category":"coding-agents","url":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","github_repo":"addyosmani/agent-skills"},"suited_tasks":["Coding agents workflows","Claude Code teams","teams that value GitHub adoption signals","Inspect source files","Explain architecture","Patch bugs and verify changes","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-code-review-and-quality"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"code-review-and-quality\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"code-review-and-quality\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"code-review-and-quality\" from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/addyosmani-code-review-and-quality/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/addyosmani-code-review-and-quality"},"trust":{"score":76,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"90K GitHub stars","repoActivity":"90K stars, 9.7K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["coding-agents","agent-skill"],"known_risks":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":87,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Require human approval before installing into a real workspace."},"quality":{"score":95,"label":"Excellent"},"supply":{"track":"Coding and developer agents","scenario":"Coding agents","maintenance":"8d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","production agents without a repository review","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface may require sandboxing","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access"],"agent_contract":{"task_input":"Use code-review-and-quality in an agent workflow","recommended_action":"Require human approval before installing into a real workspace.","install_policy":"review","minimum_review_before_use":["Trust: 76/100 Strong shortlist","Audit: 87/100 Needs review","Safety: 67/100 Review before install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"addyosmani-code-review-and-quality (code-review-and-quality)","install_command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","risk_summary":"Needs review; Reviewed with permission notes; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"addyosmani-code-review-and-quality","task":"Use code-review-and-quality in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality","api":"https://www.openagentskill.com/api/agent/skills/addyosmani-code-review-and-quality","audit":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=addyosmani-code-review-and-quality&task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/addyosmani-code-review-and-quality/install","manifest":"https://www.openagentskill.com/api/registry/manifest/addyosmani-code-review-and-quality"}},"machine_metadata":{"version":"openagentskill-agent-metadata-v2","skill":{"slug":"addyosmani-code-review-and-quality","name":"code-review-and-quality","description":"Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.","category":"coding-agents","url":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","github_repo":"addyosmani/agent-skills"},"suited_tasks":["Coding agents workflows","Claude Code teams","teams that value GitHub adoption signals","Inspect source files","Explain architecture","Patch bugs and verify changes","Inspect repository metadata","Compare code changes"],"suited_agents":["Codex","Claude Code","Cursor","OpenAgentSkill CLI","CLI"],"install":{"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","ready":true,"targets":[{"id":"openagentskill-cli","label":"CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-code-review-and-quality"},{"id":"codex","label":"Codex","kind":"agent-prompt","value":"Install the \"code-review-and-quality\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"claude-code","label":"Claude Code","kind":"agent-prompt","value":"Add \"code-review-and-quality\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."},{"id":"cursor","label":"Cursor","kind":"agent-prompt","value":"Turn \"code-review-and-quality\" from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes."}],"handoff_url":"https://www.openagentskill.com/api/skills/addyosmani-code-review-and-quality/install","manifest_url":"https://www.openagentskill.com/api/registry/manifest/addyosmani-code-review-and-quality"},"trust":{"score":76,"label":"Strong shortlist","version":"trust-score-v4","install_policy":"human_review_before_install","evidence":{"stars":"90K GitHub stars","repoActivity":"90K stars, 9.7K forks","lastPushed":"8d since push","license":"MIT","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","installSafety":"standard package or runtime install path","permissionSurface":"filesystem or document access, network or browser access","documentation":"Strong README/SKILL.md context","agentOutcomes":"No agent outcome data yet"},"outcome_evidence":{"total":0,"successes":0,"failures":0,"not_relevant":0,"success_rate":null,"recent_success_rate":null,"recent_failure_rate":null,"install_attempts":0,"install_success_rate":null,"risk_blocked":0,"setup_required":0,"avg_output_quality":null,"production_outcomes":0,"last_outcome_at":null,"label":"No agent outcome data yet"},"auto_install":{"allowed":false,"sandbox_required":true,"reason":"Human review or sandbox validation is required before automatic installation."},"best_for":["coding-agents","agent-skill"],"known_risks":["The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"agent_proven":{"version":"agent-proven-v1","score":0,"tier":"unproven","label":"Needs first agent run","summary":"No agent outcome reports yet. Use Resolve, run one narrow sandbox task, then report the result.","metrics":{"totalOutcomes":0,"successfulOutcomes":0,"failedOutcomes":0,"installAttempts":0,"installSuccessRate":null,"successRate":null,"recentSuccessRate":null,"recentFailureRate":null,"riskBlocked":0,"setupRequired":0,"notRelevant":0,"avgOutputQuality":null,"avgTimeToUsefulMs":null,"productionOutcomes":0,"humanReviewRequired":0,"uniqueAgents":0,"lastOutcomeAt":null},"signals":[],"penalties":["No real agent outcome evidence yet"]},"audit":{"score":87,"risk_level":"needs_review","risk_label":"Needs review","warnings":["Permission surface may require sandboxing","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"safety_gate":{"tier":"reviewed","label":"Reviewed with permission notes","auto_install_policy":"review","auto_install_allowed":false,"human_review_required":true,"blocked":false,"recommended_action":"Require human approval before installing into a real workspace."},"quality":{"score":95,"label":"Excellent"},"supply":{"track":"Coding and developer agents","scenario":"Coding agents","maintenance":"8d since push","risk":"Needs review"},"alternative_skills":[],"do_not_use_when":["teams that need a vendor-supported SLA","production agents without a repository review","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","Permission surface may require sandboxing","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access"],"agent_contract":{"task_input":"Use code-review-and-quality in an agent workflow","recommended_action":"Require human approval before installing into a real workspace.","install_policy":"review","minimum_review_before_use":["Trust: 76/100 Strong shortlist","Audit: 87/100 Needs review","Safety: 67/100 Review before install","Review repository, license, install command, and permission surface before production use."],"expected_agent_output":{"selected_skill":"addyosmani-code-review-and-quality (code-review-and-quality)","install_command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","risk_summary":"Needs review; Reviewed with permission notes; Review before production","verification_result":"Report the smallest successful task, files touched, warnings, and any missing setup."}},"outcome_feedback":{"endpoint":"https://www.openagentskill.com/api/agent/outcome","method":"POST","requires_resolve_event_id":true,"event_id_source":"Use install_receipt.outcome_feedback.event_id or feedback.event_id returned by /api/agent/resolve for the current task.","expected_outcomes":["success","failed","not_relevant","blocked_by_risk","setup_required"],"payload_template":{"event_id":"<install_receipt.outcome_feedback.event_id or feedback.event_id from /api/agent/resolve>","skill_slug":"addyosmani-code-review-and-quality","task":"Use code-review-and-quality in an agent workflow","agent":"codex","outcome":"success","install_used":true,"risk_blocked":false,"setup_required":false,"task_success":true,"output_quality":4,"error_type":null,"human_review_required":false,"workspace":"sandbox","time_to_useful_ms":120000,"notes":"Report the smallest successful task, setup friction, files touched, and risk notes."}},"endpoints":{"web":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality","api":"https://www.openagentskill.com/api/agent/skills/addyosmani-code-review-and-quality","audit":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality/audit","eval":"https://www.openagentskill.com/api/agent/evals?slug=addyosmani-code-review-and-quality&task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&max_risk=medium","resolve":"https://www.openagentskill.com/api/agent/resolve?task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&agent=codex&max_risk=medium","receipt":"https://www.openagentskill.com/api/agent/receipt?task=Use%20code-review-and-quality%20in%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text","install":"https://www.openagentskill.com/api/skills/addyosmani-code-review-and-quality/install","manifest":"https://www.openagentskill.com/api/registry/manifest/addyosmani-code-review-and-quality"}},"supply_profile":{"track":{"slug":"coding","label":"Coding and developer agents","shortLabel":"Coding","description":"Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills."},"scenario":{"label":"Coding agents","description":"I need a coding agent that can understand a repository, edit code, and review pull requests.","useCases":[{"slug":"coding-agents","title":"Coding agents"},{"slug":"github-automation","title":"GitHub automation"},{"slug":"testing-qa","title":"Testing and QA"}]},"applicableAgents":["Claude Code","CLI","Codex","Cursor"],"install":{"ready":true,"command":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","primaryTarget":"CLI","targetCount":4},"githubQuality":{"stars":90428,"starsLabel":"90K","forks":9671,"license":"MIT","qualityScore":95,"trustScore":76,"auditScore":87},"maintenance":{"status":"fresh","label":"8d since push","daysSincePush":8,"lastPushedAt":"2026-08-28T13:15:24+00:00"},"risk":{"level":"needs_review","label":"Needs review","requiresReview":true,"notes":["Permission surface may require sandboxing","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review."]},"coverageTags":["Coding","Coding agents","coding-agents","agent-skill"]},"audit":{"audit_score":87,"risk_level":"needs_review","risk_label":"Needs review","quality_score":95,"trust_score":76,"maintenance_score":100,"security_score":78,"install_score":92,"warnings":["Permission surface may require sandboxing","The provided SKILL.md excerpt does not include an explicit step-by-step workflow or output schema, so an agent may produce unstructured review results.","SKILL.md references 'security-and-hardening' and 'performance-optimization' but does not specify whether they are required dependencies or how to invoke them.","The skill does not state safe operating boundaries, such as treating code under review as untrusted input and avoiding execution of the change during review.","No limitations section clarifies that this review is heuristic and should not replace trusted CI or human security review.","Permission surface needs review: filesystem or document access, network or browser access","Permission surface: filesystem or document access, network or browser access"]},"quality_signals":{"model":"v2","star_score":34.69,"usage_score":0,"review_score":4.95,"metadata_score":3,"freshness_score":15},"platforms":["Claude Code"],"use_cases":[{"slug":"coding-agents","title":"Coding agents","url":"https://www.openagentskill.com/use-cases/coding-agents"},{"slug":"github-automation","title":"GitHub automation","url":"https://www.openagentskill.com/use-cases/github-automation"},{"slug":"testing-qa","title":"Testing and QA","url":"https://www.openagentskill.com/use-cases/testing-qa"},{"slug":"security-compliance","title":"Security and compliance","url":"https://www.openagentskill.com/use-cases/security-compliance"}],"stacks":[{"slug":"coding-review-agent","title":"Coding review agent","url":"https://www.openagentskill.com/collections/coding-review-agent"},{"slug":"browser-qa-agent","title":"Browser QA agent","url":"https://www.openagentskill.com/collections/browser-qa-agent"},{"slug":"rag-knowledge-base","title":"RAG knowledge base","url":"https://www.openagentskill.com/collections/rag-knowledge-base"}],"install":"npx skills add addyosmani/agent-skills --skill code-review-and-quality","install_targets":[{"id":"openagentskill-cli","label":"CLI","title":"OpenAgentSkill CLI","kind":"command","value":"npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.3.0/openagentskill-0.3.0.tgz add addyosmani-code-review-and-quality","description":"Resolve policy, run the source installer safely, and report a verified install receipt.","copyLabel":"Copy command"},{"id":"codex","label":"Codex","title":"Codex install prompt","kind":"agent-prompt","value":"Install the \"code-review-and-quality\" agent skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"codex\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Give Codex a repo-aware install prompt when the skill is not available through a local CLI.","copyLabel":"Copy prompt"},{"id":"claude-code","label":"Claude Code","title":"Claude Code skill prompt","kind":"agent-prompt","value":"Add \"code-review-and-quality\" as a Claude Code skill from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality. Inspect the skill instructions, place the reusable skill files in the appropriate local skills location for this project, and report the activation steps. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"claude-code\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this prompt to ask Claude Code to add the skill and explain the local activation steps.","copyLabel":"Copy prompt"},{"id":"cursor","label":"Cursor","title":"Cursor rule prompt","kind":"agent-prompt","value":"Turn \"code-review-and-quality\" from https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality into a reusable Cursor project rule or agent instruction. Preserve the core workflow, adapt paths to this repo, and keep the rule scoped to tasks where it is relevant. Skill purpose: Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {\"event_id\":\"install_<unique-id>\",\"skill_slug\":\"addyosmani-code-review-and-quality\",\"task\":\"Install code-review-and-quality\",\"agent\":\"cursor\",\"outcome\":\"success\",\"install_used\":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.","description":"Use this when installing as Cursor project rules or reusable agent instructions.","copyLabel":"Copy prompt"}],"repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","github_repo":"addyosmani/agent-skills","version":"1.0.0","license":"MIT","urls":{"web":"https://www.openagentskill.com/skills/addyosmani-code-review-and-quality","repository":"https://github.com/addyosmani/agent-skills/tree/main/skills/code-review-and-quality","api":"/api/agent/skills/addyosmani-code-review-and-quality","install_api":"/api/skills/addyosmani-code-review-and-quality/install"},"meta":{"created_at":"2026-08-28T13:23:34.433469+00:00","updated_at":"2026-09-01T11:59:28.941454+00:00","agent_friendly":true}}