CtrlK
BlogDocsLog inGet started
Tessl Logo

recipe-front-design

Execute from repository evidence through applicable UI Spec and optional ADR decisions to complete frontend Design Doc approval

58

Quality

67%

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-front-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, highly actionable orchestration recipe with an excellent sequenced workflow, explicit validation checkpoints, feedback loops, and a completion checklist. Its main limitations are long compound sentences in the later steps and a monolithic single-file structure with no progressive disclosure of its own.

DimensionReasoningScore

Conciseness

The body is dense and procedural with no padding of concepts Claude already knows; every sentence carries instruction and it assumes Claude's competence, matching the "efficient; minor instances that could be trimmed" anchor. Not a 5 because several sentences (Step 6 and Step 8) are long compound constructions that could be split or tightened.

4 / 5

Actionability

It specifies exact subagent invocations (e.g., "dev-workflows-frontend:codebase-analyzer", "technical-designer-frontend") with exact input fields (e.g., "prd_path: [approved PRD path]", "document_to_create: DesignDoc") and a mechanical-extraction instruction, giving mostly executable guidance. Not a 5 because several decision criteria are delegated to other skills ("Apply the documentation-criteria UI Spec creation condition", requirement-convergence) leaving minor gaps.

4 / 5

Workflow Clarity

It provides a clearly sequenced 8-step process with a flow diagram, explicit validation steps (code-verifier, document-reviewer), feedback loops (needs_revision -> Review Resolution -> re-review/re-verify), explicit [Stop] checkpoints, and a Completion Criteria checklist, matching the top anchor. Validation is present for the batch ADR operation, so no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Content is well-organized into clear sections (Outcome, Flow, Steps 1-8, Completion Criteria) with clearly signaled cross-skill references ("references/review-resolution.md", named Execute Skill lines), and for an orchestration recipe most content is appropriately inline. Not a 5 because the ~150-line body is monolithic with no own bundle files, exceeding the under-50-line simple-skill exception; not a 3 because structure and reference signaling are genuinely good.

4 / 5

Total

17

/

20

Passed

Description

53%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 conveys a clear, distinctive niche (frontend Design Doc approval via UI Spec and ADR) but is written as procedural recipe jargon rather than natural user trigger language and omits any "Use when..." guidance. It is recognizable and distinct but would benefit from explicit trigger phrasing and a third-person action list.

Suggestions

Add an explicit "Use when..." clause stating when to invoke this skill (e.g., when the user requests a Medium/Large frontend design or Design Doc approval).

Rewrite the action clause as a concrete third-person verb list (e.g., "Coordinates repository analysis, UI Spec creation, ADR batching, and Design Doc review for frontend design approval") to lift specificity.

Add natural user-facing trigger terms (e.g., "frontend design doc", "UI spec", "design approval") alongside the internal jargon to improve trigger_term_quality.

DimensionReasoningScore

Specificity

Names the frontend design domain and concrete artifacts ("repository evidence", "UI Spec", "ADR decisions", "Design Doc approval"), but the governing verb is generic ("Execute... to complete") rather than a list of concrete actions, matching the anchor that names the domain with only 1-2 concrete actions. Not a 4 because it does not list several specific actions, and not a 2 because it names multiple concrete artifacts beyond a single generic action.

3 / 5

Completeness

It gives a clear "what" (orchestrate frontend design from evidence through UI Spec/ADR to Design Doc approval) but provides no "Use when..." trigger guidance, and the rubric explicitly caps completeness at 3 when that clause is missing. Not a 4 because the "when" is only weakly implied, not explicit.

3 / 5

Trigger Term Quality

It surfaces relevant domain keywords ("UI Spec", "ADR decisions", "frontend Design Doc") but embeds them in procedural recipe jargon ("Execute from repository evidence through applicable...") rather than natural user phrasing, matching the anchor with some relevant keywords but missing common variations. Not a 4 because the framing is internal jargon a user would not naturally say; not a 2 because multiple relevant domain terms are present.

3 / 5

Distinctiveness Conflict Risk

The phrase "frontend Design Doc approval" with "UI Spec" and "ADR decisions" carves a clear, specialized niche with low conflict risk, matching the "mostly distinct; minor overlap risk" anchor. Not a 5 because the jargon-heavy phrasing and possible overlap with broader design-doc skills leave minor overlap risk.

4 / 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.

Validation15 / 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.