CtrlK
BlogDocsLog inGet started
Tessl Logo

recipe-review

Reviews completed implementation for governing-source compliance, scope economy, repository quality, and security, then applies user-approved corrections.

56

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/recipe-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 a tightly engineered 10-step orchestration recipe with unambiguous sequencing, explicit agent invocation specs, and strong validation/re-validation feedback loops — workflow clarity is excellent. Its weaknesses are prose density with some duplicated gate language that could be condensed, and heavy dependence on external skills' rules (Review Resolution Gate, Specialist Result Acceptance) that are invoked by name without inline summaries, leaving small gaps in standalone actionability.

Suggestions

Condense the duplicated passages: factor the shared re-derivation preamble of Steps 8 and 9 into the Step 1 inclusion rule ('re-derive before each re-validation'), and state the Review Resolution Gate once with per-step pointers instead of four full restatements.

Add one-line inline summaries of the externally defined rules the recipe hinges on (Review Resolution Gate disposition outcomes, Specialist Result Acceptance branches, the post-implementation Re-run rule) so the recipe remains actionable when those skills are not loaded in context.

Move the Step 4 and Step 10 report format templates and the finding-routing table into a single references file (e.g. references/report-templates.md) to shorten SKILL.md while keeping the step sequence as the overview.

DimensionReasoningScore

Conciseness

The body teaches nothing Claude already knows and contains no filler — every line is recipe instruction — but dense nominal-legalese ('Derive implementationFiles from paths changed between the current branch's merge base with the repository's default branch and the current repository state, including committed changes, working-tree changes, and untracked files') and duplicated passages (Steps 8 and 9 repeat an identical re-derivation preamble; the Review Resolution Gate is re-invoked four times) leave real tightening on the table. Mostly efficient but could be tightened: anchor 3, not 4, because the tightening opportunities exceed 'minor instances'.

3 / 5

Actionability

Every agent call carries concrete subagent_type, description, and prompt fields; Step 4 supplies an explicit routing table and a shaped report block; Step 7 defines enumerated result-routing values (pass / stub_detected / verification_incomplete / blocked). Minor gaps: several steps defer to other skills' rules ('Review Resolution Gate', 'Specialist Result Acceptance', the 'Re-run rule') without even a one-line inline summary of what those rules decide. Mostly executable guidance with minor gaps: anchor 4, not 5, because executing some steps requires loading external skill content not summarized here.

4 / 5

Workflow Clarity

Steps 1–10 run in order with each branch gated by a stated condition ('Run this step only when the user routed at least one finding to d'), explicit validation/re-validation steps (Steps 8–9), retry-with-same-inputs feedback loops for retained limitations, stub-detection recovery back to Step 6, and declared convergence conditions before progression. Matches anchor 5: clear sequence, explicit validation, feedback loops for error recovery; not 4 because no material checkpoint is missing.

5 / 5

Progressive Disclosure

The 200-line recipe is inline under clear per-step headers, its single file mention (references/review-resolution.md) is explicitly and correctly attributed to the loaded subagents-orchestration-guide skill rather than buried, and no local bundle files exist to organize. Good structure with minor gaps: anchor 4, not 3, because sections are well-signaled and navigable; not 5 because a recipe this size keeps large report templates and routing/adjudication rules inline where a one-level reference file could carry them.

4 / 5

Total

16

/

20

Passed

Description

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

The description clearly states what the skill does across four review dimensions plus correction application, but it entirely lacks a 'when to use' trigger clause and leans on internal jargon ('governing-source compliance', 'scope economy') rather than natural user phrases. It is serviceable but below the quality of the reference good examples.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when the user asks to review a completed implementation, run post-implementation QA, or verify code against its Design Doc before finishing a task.'

Replace or gloss internal jargon ('governing-source compliance', 'scope economy') with natural terms users would say, such as 'checks the implementation against its Design Doc and requirements, keeps changes within the approved scope'.

Include common trigger synonyms and concrete nouns users would mention — 'implementation review', 'code review after implementation', 'security check', 'Design Doc compliance' — to improve trigger matching and distinctiveness from generic review skills.

DimensionReasoningScore

Specificity

Names the domain (completed implementation review) and several distinct actions — governing-source compliance, repository quality, security review, and applying user-approved corrections — though 'governing-source compliance' and 'scope economy' read as internal jargon rather than fully concrete capabilities. Falls between anchors 3 and 4: several specific actions with minor gaps in coverage, not the comprehensive concreteness of anchor 5.

4 / 5

Completeness

Has a clear 'what' ('Reviews completed implementation for... then applies user-approved corrections') but no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 2 because the 'what' is clear and multi-part rather than vague.

3 / 5

Trigger Term Quality

Contains some relevant keywords ('implementation', 'security', 'corrections', 'repository quality') but is missing the natural phrases a user would actually say ('review my implementation', 'post-implementation check', 'review the PR before merge') and any synonyms or variations. Matches anchor 3; not 4 because keyword coverage lacks natural terms rather than having only a few missing.

3 / 5

Distinctiveness Conflict Risk

The post-implementation review framing is somewhat specific, but 'repository quality and security' review territory overlaps with generic code-review skills, so it could still trigger for the wrong skill. Matches anchor 3; not 4 because the overlap with closely related review skills is more than minor.

3 / 5

Total

13

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository
shinpr/claude-code-workflows
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.