CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review

Use when reviewing a staged diff or a commit range for soundness against the project's taste rules, including a pre-commit pass or an explicit "sound review".

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 lean skill body: exact commands, exact paths, verbatim rule application, an explicit failure-stop checkpoint, and a literal output format. The only soft spot is that the workflow sequence is conveyed by section ordering rather than enumerated steps, leaving minor ambiguity around per-commit handling of a range.

DimensionReasoningScore

Conciseness

Every line is an instruction: input selection ('git diff --cached', 'git diff <range>'), rule application ('apply each rule's Detect: and Not-when: verbatim'), and an output format. There is zero padding and no explanation of concepts Claude already knows. It is not 4 because there is nothing left to trim — every token earns its place.

5 / 5

Actionability

Fully concrete and executable: exact git commands, an exact rule-directory path (.claude/sound/), explicit rule fields (Detect:/Not-when:), a literal report template ('- <file>: <rule or enhancement> — <anchor>'), and a defined null output ('CLEAN'). It is not 4 because there are no gaps — the guidance covers the common cases (no argument, a range, missing rules dir) copy-paste ready.

5 / 5

Workflow Clarity

A clear sequence is laid out across sections — choose input, read the applicable rules, apply them (honoring Not-when:), report most-consequential first — with an explicit checkpoint ('If .claude/sound/ is absent, say so and stop'). It is not 5 because the sequence is implicit in section order rather than explicitly enumerated, and what to do with the individual commits of a range (vs. the aggregate diff) is left slightly ambiguous. This is a read-only review, so the destructive/batch validation cap does not apply.

4 / 5

Progressive Disclosure

The body is well under 50 lines, has no bundle files needing external references, and is cleanly organized into 'What to read' and 'How to review' sections — the simple-skill case where well-organized sections alone merit a 5. The one external pointer (.claude/sound/) is runtime project data, correctly referenced inline at one level deep rather than duplicated.

5 / 5

Total

19

/

20

Passed

Description

70%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 solid trigger-focused description with explicit when-guidance and distinctive domain vocabulary. Its main weakness is a thin "what": only one action verb ("reviewing") and no statement of what the skill produces, which also leaves it slightly generic against ordinary code-review requests.

Suggestions

State the outcome of the review explicitly, e.g. 'Surfaces every violated rule and reports findings most-consequential first' — this would raise both specificity and completeness.

Add one or two common user phrasings as triggers (e.g. 'review my changes', 'review this diff') to broaden natural keyword coverage.

Lead with the 'what' as a third-person action sentence before the 'Use when' clause, matching the strongest reference examples.

DimensionReasoningScore

Specificity

The description names the domain ("staged diff or a commit range") and one concrete action ("reviewing ... for soundness against the project's taste rules"), but stops at that single action. It is not 4 because it does not list several specific actions (e.g., what the review produces or how findings are reported); it is not 2 because the domain and action are concrete, not generic.

3 / 5

Completeness

Both parts are present: the "what" ("reviewing ... for soundness against the project's taste rules") and an explicit "Use when ..." trigger clause with concrete conditions. It is not 5 because the "what" is thin — it never states what the review actually does (surface rule violations, report findings) — and is embedded entirely inside the when-clause; it is not 3 because "when" is explicit and specific.

4 / 5

Trigger Term Quality

Natural trigger phrases users would say are present: "staged diff", "commit range", "pre-commit pass", and the explicit "sound review". It is not 5 because common synonyms and variations ("review my changes", "diff", "review this commit/PR", "taste rules") are missing.

4 / 5

Distinctiveness Conflict Risk

Terms like "soundness", "project's taste rules", and "sound review" carve a distinct niche that separates it from generic review skills. It is not 5 because "reviewing a staged diff or a commit range" still overlaps with general code-review/diff-review skills, creating minor conflict risk.

4 / 5

Total

15

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

saadshahd/moo.md

Path

sound/skills/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.