CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-loop-review-change

Review an existing change from a local or user-trusted source, such as a pull request, merge request, branch diff, commit range, or agent-written code. Use when the user needs a merge verdict, a file-wise review walk-through, reconstruction of the change after the fact, or both.

Quality

86%

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

78%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.

The body is an efficient, well-structured router with concrete conditional loading rules and a sensible guardrail workflow. Its main defect is that all four referenced guidance files are missing from the bundle, which makes the progressive-disclosure navigation and the load instructions unverifiable, and leaves the actual review mechanics entirely delegated.

Suggestions

Ship the four referenced guidance files (review-core-guidance.md, assessment-guidance.md, walk-through-guidance.md, github-gitlab-evidence-guidance.md) in the skill bundle, or inline the minimal guidance each mode needs so the router's load instructions resolve to real files.

Add one brief example review target and expected output per mode (e.g., 'PR #123 → verdict file' vs 'branch diff → file-wise walk-through') so the mode-selection rules are concrete and verifiable.

Make the step order explicit: state whether the trust/range clarification check happens before or after reading review-core-guidance.md.

DimensionReasoningScore

Conciseness

The ~40-line body is pure routing and decision guidance with zero concept explanation or padding — e.g., "Use this optional skill for work that is already implemented, not for planning or executing new work" states the scope in one sentence. Every token earns its place, matching the score-5 'lean and efficient' anchor; there is no over-explanation to trim, so it does not fall to score 4.

5 / 5

Actionability

The routing rules are concrete, conditional, and executable: "Read [review-core-guidance.md](./review-core-guidance.md) first", "Load both mode files only when the user wants both outputs", "Do not load github-gitlab-evidence-guidance.md for branch diffs, commit ranges, current local changes". It falls short of the score-5 anchor because the four referenced guidance files are not present in the skill bundle, so the load instructions cannot be verified as executable, and no illustrative example of a review target or expected output is given.

4 / 5

Workflow Clarity

A clear sequence is present: the "stop and ask before fetching" guardrail, then "Read review-core-guidance.md first", then "choose the review mode and evidence source together", then conditional loading of mode/evidence files, with spec-loop-clarify-task as a feedback path for unresolved choices. It matches the score-4 anchor rather than score 5 because some checkpoints remain implicit — e.g., whether the trust/range check precedes reading the core guidance, and what 'reconstruction of the change after the fact' concretely entails.

4 / 5

Progressive Disclosure

The body is a well-signaled, one-level-deep router ("Load only the needed guidance files" with per-mode and per-target conditions), which is structurally the score-5 pattern. However, none of the four referenced files (review-core-guidance.md, assessment-guidance.md, walk-through-guidance.md, github-gitlab-evidence-guidance.md) exist in the skill bundle — there are no references/, scripts/, or assets/ directories and no sibling .md files — so navigation dead-ends and the content split cannot be verified, dropping it to the score-3 anchor ('references present but' not verifiable as a working structure).

3 / 5

Total

16

/

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: it explicitly states what the skill does, enumerates concrete input sources and output deliverables, and includes a clear 'Use when' trigger clause. The only weaknesses are a couple of missing natural synonyms ('code review', 'review my changes') and minor trigger overlap with generic code-review skills.

DimensionReasoningScore

Specificity

The description names the concrete action ("Review an existing change"), enumerates five input source types ("pull request, merge request, branch diff, commit range, or agent-written code") and three concrete deliverables ("merge verdict, a file-wise review walk-through, reconstruction of the change"). Coverage of both inputs and outputs is comprehensive for the change-review domain, so it matches the score-5 anchor rather than the score-4 anchor's 'minor gaps in coverage'.

5 / 5

Completeness

Both questions are answered explicitly: what ("Review an existing change from a local or user-trusted source, such as a pull request, merge request, branch diff...") and when ("Use when the user needs a merge verdict, a file-wise review walk-through, reconstruction of the change after the fact, or both"). The 'when' clause is explicit with concrete trigger phrases, matching the score-5 anchor rather than the score-4 anchor's 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural terms users would say are well covered: "pull request", "merge request", "branch diff", "commit range", "merge verdict", "walk-through". A few common phrasings are missing (e.g., "code review", "review my changes"), which fits the score-4 anchor ('good keyword coverage; a few natural terms missing') rather than the score-5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche — post-hoc review of already-implemented work with verdict/reconstruction deliverables — is mostly distinct, but phrases like "Review... a pull request, merge request, branch diff" overlap with generic code-review skill triggers. This fits the score-4 anchor ('mostly distinct; minor overlap risk with closely related skills') rather than the score-5 anchor's minimal conflict risk.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 4 missing, 1 suspicious

Warning

Total

15

/

16

Passed

Repository

dpolivaev/spec-loop

Path

skills/spec-loop-review-change/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.