CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

recipe-design

Execute from codebase-scoped analysis through optional ADR decisions to complete Design Doc approval

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 ./dev-workflows-fullstack/skills/recipe-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 procedure with an unambiguous step sequence, explicit stop points, verdict routing, and error-recovery loops — exemplary workflow clarity for a multi-agent skill. It stays lean and assumes Claude's competence, with only minor rationale-padding and some mechanics delegated to other skills. Progressive disclosure is good but the skill depends on cross-skill references rather than its own bundle.

DimensionReasoningScore

Conciseness

The body is dense procedural instruction with no explanation of concepts Claude already knows, and no filler. A few sentences mix rationale with instruction (e.g. 'Keep verifier observations unchanged so corrections remain traceable to observed repository evidence instead of becoming orchestrator-authored design instructions') and could be trimmed. This matches anchor 4 (efficient, minor instances that could be tightened), not 5, because several of these rationale clauses do not earn their tokens.

4 / 5

Actionability

As an instruction-only skill it provides concrete, specific guidance: exact input field lists per invocation (e.g. 'document_to_create: DesignDoc', 'structural_scale', 'adr_paths: [accepted paths or []]', 'codebase_analysis'), verdict routing rules, and named specialist agents. It is not 5 because some mechanics (convergence fields, Review Resolution details) are delegated to other skills' references and a few directives remain abstract ('let the analyzer discover affected paths').

4 / 5

Workflow Clarity

The multi-step process is clearly sequenced (Steps 1-7 with an ASCII flow diagram), with explicit validation checkpoints ('Wait at each [Stop] for explicit user confirmation'), feedback loops for error recovery (needs_revision -> Review Resolution -> fresh designer update -> re-review with prior_feedback), and a Completion Criteria checklist. This matches anchor 5.

5 / 5

Progressive Disclosure

The body is well-sectioned and every external reference is one level deep and clearly attributed ('read references/review-resolution.md from the loaded subagents-orchestration-guide skill', 'references/criteria.md of the requirement-convergence skill'); no bundle files exist in this skill to split further. It is not 5 because the body exceeds 50 lines and leans heavily on cross-skill content without its own reference files, leaving minor organization gaps such as consolidating the repeated Review Resolution routing rules.

4 / 5

Total

17

/

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 coherent design-phase pipeline in third person, but it reads as an internal stage label rather than a user-facing trigger. It lacks any 'when to use' guidance and offers only two narrow trigger terms, capping completeness and trigger quality. Adding an explicit use-when clause with natural user phrasing would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for a design doc, technical design, ADR, or implementation plan for Medium/Large work.'

Broaden natural trigger vocabulary to include synonyms users would actually say: 'design document', 'technical design', 'architecture decision record', 'implementation design'.

State the concrete actions the skill performs (e.g. 'analyze the codebase, qualify and approve ADRs, create and verify a Design Doc with review and resolution loops') so the 'what' is comprehensive rather than stage-shorthand.

DimensionReasoningScore

Specificity

The description names the domain and pipeline stages ('codebase-scoped analysis', 'ADR decisions', 'Design Doc approval'), which are concrete, but it does not comprehensively cover what the skill actually does (orchestrate specialists, review, resolve findings). It matches anchor 3 (domain plus 1-2 concrete actions), not 4, which requires several specific listed actions.

3 / 5

Completeness

There is a clear 'what' ('Execute from codebase-scoped analysis through optional ADR decisions to complete Design Doc approval'), but the 'when' is entirely absent with not even a weak implication. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3.

3 / 5

Trigger Term Quality

'ADR decisions' and 'Design Doc approval' are the two natural niche terms, but the description offers no synonyms, user-phrase variations, or broader trigger vocabulary. It sits between anchor 1 (only technical jargon) and anchor 2 (one or two keywords, missing natural phrases), landing at 2 because those two terms are what a user of this workflow would actually say.

2 / 5

Distinctiveness Conflict Risk

The ADR/Design-Doc approval niche is clearly distinguishable from generic coding or documentation skills, with only minor overlap risk against closely related requirements or planning skills. This matches anchor 4 rather than 5 because no explicit distinct triggers are given.

4 / 5

Total

12

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

shinpr/claude-code-workflows

Path

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