CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review

Reviews the changes since a fixed point (commit, branch or merge-base) on two axes, in parallel subagents. Standards: does the code follow this repo's guidelines? Spec: does it do what the issue asked? Use when the user asks to review a branch, a PR or work in progress, or to "review since X".

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary instruction-only skill body: lean, fully executable (exact git commands, verbatim subagent briefs, prescribed edge-case outcomes), and a clearly sequenced workflow with explicit validation and termination checkpoints. The one real defect is that the workflow's load-bearing reference, ./rules.md, is not present in the bundle, so the promised content split cannot be followed as written.

Suggestions

Ship rules.md inside the skill bundle (e.g., references/rules.md) and update the three ./rules.md links — step 4 requires pasting its 'Edge cases and guards' section in full, which is impossible when the file is absent.

If rules.md intentionally lives outside the bundle (e.g., at the repo root alongside AGENTS.md), say so explicitly at first mention so the relative link does not read as a bundle file that fails to resolve.

DimensionReasoningScore

Conciseness

The body is ~28 lines with zero padding: no git/Linear/GitHub concepts are explained ("Fetch the issue with the Linear or GitHub tools" assumes competence), and constraints are stated as tight imperatives ("At most 400 words", "Stop here if the diff is empty"). Every sentence instructs. This matches the 'lean and efficient; every token earns its place' anchor. Not 4: there are no over-explanations to trim.

5 / 5

Actionability

Concrete commands are given verbatim ("git diff <fixed-point>...HEAD", "git log --oneline <fixed-point>..HEAD", "Confirm it with git rev-parse"), discovery patterns are specified ("a Linear key (SB-1234) or Closes #N"), and both subagent briefs are quoted copy-paste ready with word limits. The output format is fully determined ("## Standards" / "## Spec", one summary line per axis). Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this actionable. Not 4: no gaps — even the empty-diff and no-spec edge cases have prescribed outcomes.

5 / 5

Workflow Clarity

Five numbered, strictly ordered steps with explicit checkpoints: "Confirm it with git rev-parse", "Stop here if the diff is empty", a fallback chain for spec discovery (spec file → tracker key → PR body → "no spec"), and a termination condition ("Done when both axes have reported, or the Spec axis has reported 'no spec'"). The workflow is read-only, so the destructive/batch validation cap does not apply. Not 4: validation and exit conditions are explicit at every decision point, not mostly present.

5 / 5

Progressive Disclosure

The body itself is well organized (under 50 lines, clear sections) and its single reference is clearly signaled and one level deep: "Both follow the [review rules](./rules.md)", "the section 'Edge cases and guards' from [the review rules](./rules.md), pasted in full". However, no bundle directories (references/, scripts/, assets/) exist and rules.md is absent from the bundle, so the skill's central reference — whose content step 4 depends on — dead-ends. Not 4: a missing referenced file is more than a 'minor organization gap'; not 2: the reference is clearly signaled, not buried, and nothing is wrongly inlined.

3 / 5

Total

18

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete on both axes of what it does, and explicit about when to trigger it with natural user phrasings including a quoted 'review since X'. Trigger coverage and distinctiveness are very good but not exhaustive — common synonyms like 'code review' are absent and generic review requests could collide with other review skills.

DimensionReasoningScore

Specificity

Quotes: "Reviews the changes since a fixed point (commit, branch or merge-base) on two axes, in parallel subagents", "Standards: does the code follow this repo's guidelines?", "Spec: does it do what the issue asked?" — multiple concrete, distinct actions (diff-since-fixed-point review, standards check, spec check) plus the execution mechanism, comprehensively covering the skill's scope. Not 4: anchor 4 tolerates 'minor gaps in coverage', and no capability of the skill is left unmentioned. Third-person voice, so no voice penalty applies.

5 / 5

Completeness

The 'what' is explicit ("Reviews the changes since a fixed point ... on two axes, in parallel subagents", with both axes defined) and the 'when' is explicit with concrete trigger phrases ("Use when the user asks to review a branch, a PR or work in progress, or to 'review since X'"). This clearly matches the anchor 5 example's structure of what + when with concrete triggers. Not 4: the 'when' clause is already fully explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Quotes: "review a branch, a PR or work in progress", "to 'review since X'" — several natural phrasings users would actually say, including a quoted verbatim trigger. Not 5: common synonyms like "code review", "review my changes" or "review the diff" are missing. Not 3: coverage goes well beyond 'some relevant keywords' with multiple natural user phrasings.

4 / 5

Distinctiveness Conflict Risk

Quotes: "since a fixed point (commit, branch or merge-base)", "Standards", "Spec", "review since X" — a clearly carved niche with distinctive framing. Not 5: triggers like "review a PR" are shared with generic code-review skills, leaving minor overlap risk with closely related skills. Not 3: the two-axis, fixed-point framing is far more specific than 'somewhat specific'.

4 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 3 missing

Warning

Total

13

/

16

Passed

Repository

storybookjs/storybook

Path

.agents/skills/code-review/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.