CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-driven-development

Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. Use when a single requirement spans several independently testable capabilities and needs decomposing into a capability map of modules before specifying.

68

Quality

82%

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

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.

A well-structured, actionable skill body built around a clearly gated four-phase workflow with explicit validation checkpoints and feedback loops. It assumes Claude's competence and supplies concrete templates and commands, with only minor conciseness and organization refinements possible.

DimensionReasoningScore

Conciseness

Efficient and assumes Claude's competence without padding basic concepts; a few explanatory sentences and the multi-row rationalizations table could be trimmed further.

4 / 5

Actionability

Provides concrete templates (spec, task, capability map), full commands, and explicit file-naming conventions, with only minor gaps where process steps are guidance rather than commands.

4 / 5

Workflow Clarity

Explicit four-phase gated workflow plus a Phase 0 scope check, human review gates at each phase, a verification checklist, and clear feedback loops ('Correct me now', 'Are these the right targets?').

5 / 5

Progressive Disclosure

Well-organized single-file structure with clearly signaled, one-level-deep references to sibling skills in blockquotes; no bundle files exist to split further, and full templates are inlined appropriately.

4 / 5

Total

17

/

20

Passed

Description

83%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.

A strong, third-person description that clearly states what the skill does and gives three explicit 'Use when' trigger clauses covering new work, ambiguous requirements, and multi-capability decomposition. Trigger language is natural and distinctive, with only minor room for broader synonym coverage.

DimensionReasoningScore

Specificity

Names the domain and concrete actions ('Creates specs before coding', 'decomposing into a capability map of modules'), but does not enumerate multiple distinct actions to reach comprehensive coverage.

4 / 5

Completeness

Explicitly states what ('Creates specs before coding') and provides three concrete 'Use when...' trigger clauses, clearly answering both what and when.

5 / 5

Trigger Term Quality

Strong natural trigger phrases ('starting a new project, feature, or significant change', 'requirements are unclear, ambiguous', 'vague idea') match what users would say, with only minor synonyms missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche (specification-first, capability maps) with distinct triggers, but minor overlap risk with adjacent planning skills referenced in the body.

4 / 5

Total

17

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
addyosmani/agent-skills
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.