Skip to content
SkillModel-led2,703 tokens in use

Code Review

Review code for correctness first, with performance and security as options, and report only defects that survived a check of the strongest counterargument.

680 stars on the repository MIT Licensephuryn/product-engineering · ai-shipping/skills/code-review
npx skills add phuryn/product-engineering
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Code Review costs

36tokens idle
2,703tokens in use
6,240tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter8/15
  • Structure19/25
  • Examples15/15
  • Output15/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity100
  • Maintenance100
  • Community44
  • Maturity4
  • Momentum40

Code Review answers requests like “review this”, “find bugs” or “is this fix safe”. It looks for disagreements between participants that each look reasonable alone, such as caller and callee, producer and consumer, or a value written now and read later, and reports a finding only when it can show a violating execution.

Correctness is the default. Performance and security are optional dimensions that use the same engine, selected with dimensions=performance, dimensions=security or dimensions=all.

What You Get

  • A findings report with expectation, trigger, defect, evidence for every participant, impact, refutation, remedy and verification
  • A coverage statement that says what was examined and what was not
  • Separate unresolved items for contracts or runtime facts that are unknown
  • Reference files for a correctness taxonomy of thirteen lenses, and for performance and security sub-cases
  • Invocation arguments for dimensions and scope

Common Use Cases

  • Reviewing working changes before a push
  • Checking whether a bug fix is safe
  • Auditing a flow where two components must agree, such as a retry path or a cache
  • Running a combined correctness and security review of a repository

What Makes It Unique

The skill reviews agreements between participants, which a file-by-file checklist cannot hold together, and it forces two probes that agents rarely run: authority reconciliation and identity correlation. Every candidate has to survive refutation, and the skill rules that a cache that usually holds or a race that usually resolves correctly does not count as prevention. Zero supported findings is a valid result, and the report never says the code is bug-free.

Under The Hood

The skill is instructions with reference files and no scripts. The agent reads the repository and the working changes, follows dependencies beyond changed lines and, for a large scope, can spawn read-only workers that search and navigate but must not edit the tree. The agent confirms the tree is unchanged when the run ends. It reports and applies fixes only when asked. It does not fetch web pages or call APIs.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers