addyosmani/agent-skills

code-review-and-quality

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. Use when asked to review a diff or a pull request, even when the diff is pasted inline.

66K installs 108K stars

Before you install

Last update
Files in folder
1
Scripts
No script files found
SKILL.md size
20 KB (about 5,244 tokens of context each time it loads)
License
MIT
Source on GitHub
addyosmani/agent-skills

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Install

npx skills add addyosmani/agent-skills@code-review-and-quality

Runs in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.

Install for your agent

npx skills add addyosmani/agent-skills@code-review-and-quality --agent claude-code -y
Project install writes to
.claude/skills/code-review-and-quality
Global install writes to
~/.claude/skills/code-review-and-quality

Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /code-review-and-quality.

What it does

Code Review and Quality Overview Multi-dimensional code review with quality gates. Every change gets reviewed before merge — no exceptions. Review covers five axes: correctness, readability, architecture, security, and performance. 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. When to Use - Before merging…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

Categories

Related skills

  • security-and-hardening

    addyosmani/agent-skills

    Hardens code against vulnerabilities. Use when auditing an input handler for vulnerabilities, when handling user input, authentication, data storage, or external integrations, or when checking a login flow is safe against the OWASP Top Ten. Use when building any feature that accepts untrusted data, manages user sessions, or interacts with third-party services. Use when auditing dependencies for known vulnerabilities, triaging package-manager audit findings, or assessing supply-chain risk in a new package. Use when personal data or privacy compliance (GDPR, CCPA) is involved.

    63K installs 108KSecurityDataCode review
  • frontend-ui-engineering

    addyosmani/agent-skills

    Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

    60K installs 108KDesign & UIReact & Next.js
  • spec-driven-development

    addyosmani/agent-skills

    Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or requirements document with objectives and scope, or when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.

    58K installs 108KWriting
  • performance-optimization

    addyosmani/agent-skills

    Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.

    58K installs 108K
  • planning-and-task-breakdown

    addyosmani/agent-skills

    Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

  • documentation-and-adrs

    addyosmani/agent-skills

    Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

    57K installs 108KDesign & UIDocumentation

← Search skills

/skills/addyosmani/agent-skills/code-review-and-quality/