CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-diagnose

Investigate problem, verify findings, and derive solutions

Quality

68%

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-diagnose/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 well-engineered orchestration workflow: clearly sequenced steps, concrete subagent invocation templates, explicit quality gates, coverage-convergence feedback loops, and completion checklists. Its main weaknesses are moderate redundancy across the gating/convergence rules and abstract scope-envelope prose that could be tightened, plus external skill references that lack invocation mechanics.

DimensionReasoningScore

Conciseness

Mostly operational rather than explanatory, but contains noticeable tightening opportunities: the Execution Gate paragraph duplicates Step 4's convergence rules, coverage criteria appear in both Step 3 and Step 4, the 'Context Separation' note restates Step 0's envelope independence, and the abstract scope-envelope prose ('newly discovered areas are inside the envelope only when they have one of the relationships above...') is denser than needed. Not 2 because no Claude-known concepts are explained and there is no padding; not 4 because the redundancy and abstract phrasing exceed minor instances.

3 / 5

Actionability

Provides concrete, copy-paste-ready Agent tool invocations with exact subagent_type, description, and prompt templates, a mechanical extraction rule for filling placeholders ('copy the named source values into the exact fields, apply only the declared serialization'), a re-run prompt for quality failures, and two complete report templates. Not 5 because the two prerequisite skills ('Execute Skill: llm-friendly-context', 'Execute Skill: subagents-orchestration-guide') are named without invocation mechanics or paths, and placeholder assembly still depends on orchestrator judgment in edge cases.

4 / 5

Workflow Clarity

Steps 0-7 are clearly sequenced with an explicit Execution Gate, a Step 2 quality-check checklist with a re-run feedback loop, Step 4 coverage convergence with enumerated branch conditions and dispositions (closed / gaps_remaining / evidence_unavailable), a defined return path to Step 1, and a final Completion Criteria checklist. This matches the anchor for clear sequence, explicit validation steps, error-recovery feedback loops, and checklists; no validation gaps identified for this non-destructive workflow.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ absent) and the ~220-line body is well-organized with clear headers, inline prompts, and report templates integral to the flow. Not 5 because the two report templates (~50 lines) could be split into a references file at this length, the two external skill executions are not clearly signaled with paths, and Step 0 sits outside the 'Execution Steps' section; not 3 because nothing is buried and the structure is genuinely good.

4 / 5

Total

16

/

20

Passed

Description

46%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 communicates a clear three-step process (investigate, verify, derive solutions) but is held back by the absence of any 'when to use' guidance, missing natural diagnosis trigger terms, and generic wording that creates high overlap risk with other problem-solving skills. It reads more like an internal recipe summary than a discoverability description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user reports a bug, unexpected behavior, or asks to find the root cause of a problem or diagnose a failure.'

Include natural trigger terms users would actually say — 'diagnose', 'root cause', 'debug', 'troubleshoot', 'why is X happening' — rather than only abstract process verbs.

Narrow the domain to reduce conflict risk, e.g. 'Root-cause analysis of reported problems in a codebase or system: map execution paths, verify failure points, and derive fixes.'

DimensionReasoningScore

Specificity

Lists three distinct workflow actions ("Investigate problem", "verify findings", "derive solutions") forming a coherent process, but names no domain and the objects are generic. Not 4 because the gap is major (no domain, no concrete artifacts); not 2 because the actions are neither minimal nor a single generic verb.

3 / 5

Completeness

The 'what' is stated as a three-phase process, but there is no 'Use when...' clause or equivalent trigger guidance, capping completeness at 3 per the rubric guidelines. Not 4 because the 'when' is entirely absent rather than merely imprecise; not 2 because the 'what' is clearly articulated with three concrete verbs.

3 / 5

Trigger Term Quality

Contains some relevant keywords ("investigate", "problem", "verify", "solutions") but misses the natural phrases a user would say for diagnosis work: "diagnose", "root cause", "debug", "troubleshoot", "bug", "fix". Not 4 because common variations and synonyms are absent; not 2 because more than one or two relevant keywords are present.

3 / 5

Distinctiveness Conflict Risk

"Investigate problem, verify findings, and derive solutions" is very broad and would overlap with virtually any debugging, troubleshooting, analysis, or research skill. Not 1 because it would not trigger for unrelated skills (documents, charts, PDFs); not 3 because no niche or differentiating trigger is stated despite the skill name 'recipe-diagnose' suggesting one.

2 / 5

Total

11

/

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

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.