CtrlK
BlogDocsLog inGet started
Tessl Logo

recipe-front-plan

Create frontend work plan from design document and obtain plan approval

60

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is a well-sequenced, actionable orchestrator workflow with explicit review and feedback checkpoints, but it is a monolithic single file with minor redundancy and no progressive disclosure to separate reference files.

Suggestions

Trim redundant framing such as the 'Context' line and repeated subagents-orchestration-guide mentions to tighten token efficiency.

Move the detailed per-step sub-agent invocation specs into a referenced bundle file (e.g., references/subagent-invocation.md) to improve progressive disclosure and keep SKILL.md as an overview.

Convert named external skill references into clearly signaled links so navigation is explicit.

DimensionReasoningScore

Conciseness

The body is mostly lean orchestration instruction without explaining concepts Claude already knows, but lines like 'Context: Dedicated to the frontend planning phase' and repeated references to subagents-orchestration-guide could be tightened, matching 'mostly efficient but includes some unnecessary explanation'.

2 / 3

Actionability

It supplies concrete, executable delegation parameters (exact subagent_type strings, description values, and prompt templates with [path] placeholders), giving copy-paste-ready guidance appropriate for an instruction-only orchestrator skill.

3 / 3

Workflow Clarity

Steps 1-5 are clearly sequenced, and Step 4 defines an explicit validation/feedback loop ('on needs_revision, re-invoke... repeating until approved') plus an escalation path, matching 'clear sequence with explicit validation steps; feedback loops for error recovery'.

3 / 3

Progressive Disclosure

Sections are well-organized, but at over 50 lines the content is a monolithic single file with no bundle files to offload detail into, and external skill references are named rather than linked, fitting 'some structure but content that should be separate is inline'.

2 / 3

Total

10

/

12

Passed

Description

60%

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 is specific and names concrete actions, but it omits any explicit 'when to use' trigger guidance and relies on somewhat domain-specific terms, limiting trigger quality, completeness, and distinctiveness.

Suggestions

Add an explicit 'Use when...' clause naming natural user triggers (e.g., 'Use when planning frontend implementation from a design document or when the user asks to create a frontend work plan').

Include common user phrasings or variations (e.g., 'frontend plan', 'design doc', 'plan frontend work') to improve trigger term coverage.

Clarify the distinct trigger that separates this from general planning skills to reduce conflict risk.

DimensionReasoningScore

Specificity

Phrases 'Create frontend work plan from design document' and 'obtain plan approval' list multiple concrete, distinct actions rather than vague language, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It clearly states what the skill does but provides no 'Use when...' or equivalent explicit trigger for when to use it, so per the guidelines completeness is capped at 2.

2 / 3

Trigger Term Quality

Terms like 'frontend work plan', 'design document', and 'plan approval' are relevant but somewhat domain-jargon and lack common user phrasings or variations, fitting 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

The frontend-planning niche is fairly specific, but without explicit distinct triggers it could still overlap with other general planning skills, matching 'somewhat specific but could still overlap'.

2 / 3

Total

9

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

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.