Dev & Engineering

Pre-Merge Code Quality Review

Review every change across correctness, readability, architecture, security, and performance before it reaches the main branch.

49/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 111k
Last updated
15d ago
License
MIT
code-reviewquality-gatessecurity-reviewperformance-review
+3architecture-reviewchange-sizingdependency-review

What does this skill do, and when should you use it?

This skill defines a multi-axis code review workflow for AI coding agents and engineering teams. It evaluates correctness, readability and simplicity, architecture, security, and performance before merge, while requiring evidence from tests, builds, and other verification. It also covers severity labels, structural remedies, change sizing, dead-code hygiene, dependency upgrades, and review speed. It is a strong fit for teams seeking a consistent quality gate, but it does not replace project-specific testing or security tooling.

Establishes the change intent, specification, and expected behavior; reviews tests first for behavioral coverage, edge cases, and regression protection; walks through each changed file across five review axes; labels findings as Required, Critical, Nit, Optional, or FYI; checks the author's test, build, manual, and UI-verification evidence; identifies potentially orphaned code after refactoring and asks before deleting it; reviews dependency additions and upgrades through maintenance, vulnerability, license, changelog, lockfile, and test-verification checks.

Good fit
  • A developer has completed a feature or bug fix and needs a structured review before merging it.
  • A team is evaluating code written by another agent or model and needs evidence-based correctness, security, and architecture feedback.
  • A maintainer is reviewing a refactor and needs to determine whether it actually reduces complexity.
  • A pull request contains a dependency upgrade or lockfile change and needs focused supply-chain and verification review.
  • A change is too large to review comfortably and the team needs concrete strategies for splitting it into smaller units.

How do you install this skill?

Before you use it
  • This is a static source-only assessment; the skill, CI, and review process were not executed.
  • The skill requires test and build verification but does not define concrete commands, output formats, or failure-handling protocols.
  • Referenced security-and-hardening and performance-optimization materials were not supplied as selected evidence, so their completeness cannot be confirmed.
  • The publisher is not verified by the FollowSkills enterprise registry and is treated as unknown.
Before you start
Your agent needs
  • Local filesystem

Install the individual skill with the repository's documented skills CLI command:
npx skills add addyosmani/agent-skills --skill code-review-and-quality
The README does not document a single platform-neutral destination directory; alternatively, place the skill folder using the installation method supported by the target Agent Skills-compatible client.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/code-review-and-quality" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Trigger it before merging a change, for example: Review this change for correctness, readability, architecture, security, and performance before merge. It is also intended for completed features, refactors, bug fixes, and changes produced by another agent or model.

What are this skill's strengths and limitations?

Pros
  • Defines five explicit review dimensions spanning behavior, structure, security, and performance.
  • Requires reviewing tests and the verification story instead of treating passing tests as sufficient.
  • Provides severity labels and named structural remedies that make feedback actionable.
  • Includes practical guidance for change sizing, splitting, dead code, review cadence, and dependency upgrades.
Limitations
  • The SKILL.md does not specify commands for automatically running tests, builds, npm audit, or performance profiling.
  • Review quality depends on the agent's access to the changed files, tests, and verification evidence.
  • Detailed security and performance guidance points to other repository skills or reference files and is not fully contained in this one file.
  • The source provides no standalone test suite, benchmark results, or platform compatibility test results.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Pre-Merge Code Quality Review this page 49 · Use with care ★ 111k 15d ago MIT
Loki Mode Autonomous SDLC Skill 53 · Use with care ★ 1.1k 20d ago NOASSERTION
Code Review Agent Skill 30 · Not recommended ★ 7.3k 14d ago Apache-2.0
Open Code Review Skill 58 · Recommended ★ 47k 14d ago Apache-2.0
Session Code Review ✓ Microsoft · Official 51 · Use with care ★ 194k 14d ago MIT

The README names Superpowers and Matt Pocock's skills as alternatives and links to a repository comparison document, but the supplied source does not provide specific comparison conclusions.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
49/ 100 5-point scale 2.5 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust14 / 25 · 2.8/5

The skill explicitly covers input validation, secret handling, authorization, untrusted external data, dependency vulnerabilities, and lockfile review, and asks before deleting dead code. It does not systematically define least privilege, data-flow disclosure, user confirmation, rollback, or source attribution, so points are deducted.

2Reliability8 / 20 · 2.0/5

The five-axis process, severity taxonomy, abnormal-path checks, and verification checklist are reasonably coherent. However, there are no dedicated tests, execution commands, or concrete diagnostic behavior for this skill's key paths; static evidence is limited and the score remains below the static cap.

3Adaptability10 / 15 · 3.3/5

The audience, invocation timing, and review scope are clear for pre-merge and code-change reviews. Non-fit boundaries, input/output expectations, semantic trigger exclusions, and Chinese or cross-agent environment support are not clearly specified, so points are deducted.

4Convention8 / 15 · 2.7/5

The document has clear sections for overview, triggers, process, categorization, checklist, verification, and related references. Repository context supplies an MIT license, maintainer information, and contribution path, but versioning, changelog, detailed maintenance ownership, installation notes, and FAQs are incomplete.

5Effectiveness6 / 15 · 2.0/5

The skill provides directly usable five-axis review guidance, sizing and splitting strategies, severity labels, and verification requirements, so it can perform the core task. No representative review outputs, executed results, or comparative-benefit evidence are provided, leaving substantial judgment and tooling work.

6Verifiability3 / 10 · 1.5/5

The skill contains auditable checklists and verification criteria, and repository context includes CI validation. The supplied test fixture is unrelated to this skill, and there is no evidence independently reproducing its review behavior or quality, so the score is limited.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does it automatically approve or reject a merge?
It defines Approve and Request changes verdicts, but the source does not say that it directly operates a code-hosting platform or merges changes.
Does it only check tests?
No. Tests are one step in a broader review covering correctness, readability, architecture, security, and performance.
How does it handle large pull requests?
It recommends splitting them by stacked changes, file groups, horizontal layers, or vertical feature slices; around 1,000 changed lines is described as too large in ordinary cases.
Is it suitable for AI-generated code?
Yes. The skill explicitly covers code written by the reviewer, another agent, a model, or a human, and calls for heightened scrutiny of AI-generated code.

More skills from this repository

All from addyosmani/agent-skills

Dev & Engineering

Code Clarity Refactor

Reduce code complexity while preserving exact behavior, so teammates can read, modify, and debug it faster.

★ 111k FS 57 Use with care 15d ago
Dev & Engineering

Doubt-Driven Development

Challenge non-trivial decisions with a fresh adversarial review before they stand.

★ 111k FS 52 Use with care 15d ago
Automation & Ops

CI/CD Pipeline Automation

Build repeatable quality gates and reversible deployment pipelines for every change.

★ 111k FS 48 Use with care 15d ago
Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

★ 111k FS 55 Use with care 15d ago
Automation & Ops

Security Hardening Engineering Skill

Gives coding agents a structured defense workflow for untrusted input, authentication, sensitive data, and external service integrations.

★ 111k FS 52 Use with care 15d ago
Dev & Engineering

Browser DevTools Testing

Validate and debug web applications with real-browser runtime evidence.

★ 111k FS 59 Recommended 15d ago
Dev & Engineering

Performance Optimization Engineering Skill

Measure, diagnose, and verify fixes for frontend, backend, query, and database performance bottlenecks.

★ 111k FS 54 Use with care 15d ago
Dev & Engineering

Planning & Task Breakdown

Turn clear requirements into ordered, implementable, and verifiable engineering tasks.

★ 111k FS 54 Use with care 15d ago
Dev & Engineering

Architecture Decisions & Docs

Preserve engineering context by documenting decisions, APIs, and the reasons behind them.

★ 111k FS 53 Use with care 15d ago
Design & Frontend

Production Frontend UI Engineering

Guides AI coding agents to build accessible, responsive, design-system-aligned production interfaces.

★ 111k FS 53 Use with care 15d ago
Dev & Engineering

Deprecation & Migration

A practical workflow for retiring legacy systems safely and moving users to replacements.

★ 111k FS 48 Use with care 15d ago
Automation & Ops

Safe Launch

Guides engineering teams through observable, reversible, and incremental production releases.

★ 111k FS 46 Use with care 15d ago
Dev & Engineering

Engineering Workflow Navigator

Find and invoke the right engineering workflow skill for each task phase.

★ 111k FS 46 Use with care 15d ago
Dev & Engineering

Intent Interviewer

Clarify the real problem through one-question-at-a-time interviews before planning or coding.

★ 111k FS 59 Recommended 15d ago
Dev & Engineering

Test-Driven Development Workflow

Prove intended behavior with a failing test before implementing, refactoring, and verifying the change.

★ 111k FS 57 Use with care 15d ago
Dev & Engineering

Git Workflow & Release Discipline

Keep AI-generated changes reviewable, reversible, and ready to release.

★ 111k FS 54 Use with care 15d ago
Automation & Ops

Production Observability

Make production behavior visible and diagnosable with structured logs, metrics, traces, and actionable alerts.

★ 111k FS 53 Use with care 15d ago
Dev & Engineering

Incremental Implementation

Deliver multi-file engineering changes through small, tested, reversible slices.

★ 111k FS 52 Use with care 15d ago
Dev & Engineering

Idea Refine

Turn vague ideas into tested, actionable product directions.

★ 111k FS 51 Use with care 15d ago
Dev & Engineering

Source-Driven Development

Ground framework and library decisions in current official documentation instead of stale memory.

★ 111k FS 51 Use with care 15d ago

Related skills