CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review

Diff-scoped correctness review that reads the codebase around the change — callers, contracts, and invariants — and returns line-anchored findings ranked by severity with confidence, then a merge-risk verdict. Use for reviewing a PR, diff, or named change set. Not for style review, approvals-as-rubber-stamp, or editing the code.

Quality

93%

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.

A tight, senior-level review playbook: concrete commands, an ordered hunt list, an evidence taxonomy, a confidence gate, and a precise output template, all in ~110 well-sectioned lines with no bundle-file overhead. The only wrinkle is mild redundancy between the 'Evidence, not speculation' and 'Confidence gate' sections.

DimensionReasoningScore

Conciseness

The body is efficient and assumes reviewer competence ('Most "looks wrong" findings die here — or get sharper'), but the 'Evidence, not speculation' and 'Confidence gate' sections partially restate the same rule about excluding unconfirmed findings. This fits anchor 4 ('minor instances of over-explanation that could be trimmed') rather than 5's 'every token earns its place'.

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: concrete commands ('git diff <base>...HEAD', 'gh pr diff', 'codewhale review --pr <N> --json'), a defined severity vocabulary (blocker/concern/nit), an exact output template, and named tool invocations. Per the code_vs_instruction note, absence of code is not penalized when guidance is this actionable.

5 / 5

Workflow Clarity

The hand-review workflow is a clear numbered sequence (establish the change → read callers and contracts → read error paths) with conditional fallbacks for tool availability, and the confidence gate acts as an explicit validation checkpoint with a defined escape valve ('considered, could not confirm') for unconfirmed items. This matches the 5 anchor's clear sequence with explicit validation steps.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories and no references to any; nothing is inlined that belongs in a separate file, sections are well-organized and easy to navigate, and the body appropriately delegates to the shared 'codewhale review' core rather than duplicating it. This matches the 5 anchor's 'content appropriately split; easy navigation' given there is nothing to disclose further.

5 / 5

Total

19

/

20

Passed

Description

92%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: concrete capabilities, explicit 'Use for' triggers, and explicit negative scope that disambiguates it from neighboring skills. The only gap is modest trigger-term breadth — natural phrases like 'code review' or 'review my changes' are not included. Third person voice is used throughout, per the guidelines.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'reads the codebase around the change — callers, contracts, and invariants', 'returns line-anchored findings ranked by severity with confidence, then a merge-risk verdict' — giving comprehensive coverage of what the skill does, matching the 5 anchor rather than 4's 'minor gaps'.

5 / 5

Completeness

It explicitly answers both what ('Diff-scoped correctness review that reads the codebase... returns line-anchored findings... then a merge-risk verdict') and when ('Use for reviewing a PR, diff, or named change set') with concrete trigger phrases, exactly matching the 5 anchor.

5 / 5

Trigger Term Quality

'Use for reviewing a PR, diff, or named change set' provides good natural keyword coverage, but common user phrasings like 'code review', 'review my changes', or 'staged changes' are absent. This fits anchor 4 ('a few natural terms missing') better than 5's 'comprehensive coverage including synonyms and file extensions', while clearly exceeding 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (diff-scoped correctness review) and adds explicit exclusions — 'Not for style review, approvals-as-rubber-stamp, or editing the code' — which sharply reduces conflict risk with adjacent skills, matching the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

Hmbown/Codewhale

Path

crates/tui/assets/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.