CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-diagnose

Investigate problem, verify findings, and derive solutions

Quality

75%

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 ./dev-workflows-fullstack/skills/recipe-diagnose/SKILL.md

The canonical home for this skill is recipe-diagnose in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 written orchestration recipe: every step has concrete Agent invocation templates, explicit expected outputs, verification gates, and a well-defined convergence loop. Minor gains are possible by trimming restated gating logic and moving the report templates to a reference file. Strong result overall.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no explanations of concepts Claude already knows; every section adds novel orchestration rules. Minor trimming is possible — gating logic is restated across the Execution Gate paragraph, Step 4, and the Completion Criteria, and a few summary sentences ("The envelope bounds relevance") could be cut. Not 5 because of this restated gating logic; not 3 because there is no padding or unnecessary concept explanation.

4 / 5

Actionability

Agent invocations are copy-paste ready with exact subagent_type, description, and prompt templates, plus a mechanical-extraction rule for filling fields ("copy the named source values into the exact fields, apply only the declared serialization, then invoke immediately"). Expected outputs, quality-check field lists, and both final report templates are fully specified. As an instruction-only skill, the guidance is concrete and executable throughout.

5 / 5

Workflow Clarity

Steps 0–7 are clearly sequenced with an explicit quality-check checklist (Step 2), a verification gate (Step 3), a coverage-convergence feedback loop with re-run instructions and named-gap propagation (Step 4), a solver prerequisite ("coverageDisposition: closed"), and a completion-criteria checklist. Validation checkpoints and error-recovery loops are explicit at every stage.

5 / 5

Progressive Disclosure

A single self-contained file with well-organized sections and no bundle files to reference (references/, scripts/, assets/ are absent, and the body does not point to any nonexistent paths). The two Step 7 report templates and the agent prompt blocks could arguably move to a references/ file to slim the main body. Not 5 because the ~220-line body inlines template content that a split-out reference could hold; not 3 because nothing is buried and navigation is easy.

4 / 5

Total

18

/

20

Passed

Description

50%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 states a clear three-stage capability (investigate, verify, derive solutions) but is domain-free and lacks any "Use when..." trigger guidance. It would benefit from naming what kinds of problems it handles and the natural trigger phrases users would say. All dimensions land at the midpoint.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when the user reports a bug, unexpected behavior, or asks to find the root cause of a failure.'

Anchor the capability in a domain, e.g. 'Diagnose root causes of code, build, or system failures by investigating execution paths and verifying each failure point against evidence.'

Include natural synonyms users actually say — 'debug', 'diagnose', 'root cause', 'troubleshoot' — to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The description names three actions ("Investigate problem, verify findings, and derive solutions") but names no domain or artifact type — "problem" is generic, unlike the concrete anchors ("Extracts text from PDF files"). It is not score 4 because the verbs are abstract problem-solving terms rather than concrete, domain-anchored actions; not score 2 because three distinct actions are explicitly listed.

3 / 5

Completeness

The "what" is stated (investigate, verify, derive solutions) but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not 4 because the "when" is entirely absent rather than just underspecified.

3 / 5

Trigger Term Quality

It includes some relevant keywords ("problem", "investigate", "verify", "solutions") but misses the natural phrases users say for this task — "debug", "diagnose", "root cause", "bug", "troubleshoot", "fix". Not 4 because common variations and synonyms are largely absent; not 2 because the terms present are on-topic rather than fully generic.

3 / 5

Distinctiveness Conflict Risk

The investigate→verify→solve pipeline structure is somewhat distinctive, but the domain-free wording ("problem") overlaps with debugging, troubleshooting, and code-review skills. Not 4 because without a domain qualifier it could trigger for nearly any issue-reporting request; not 2 because the three-stage structure differentiates it from a fully generic one-liner.

3 / 5

Total

12

/

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

shinpr/claude-code-workflows

Path

dev-workflows-fullstack/skills/recipe-diagnose/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.