Closing the intent-to-code chasm - specification-driven development with BDD verification chain
Overall
score
96%
Does it follow best practices?
Validation for skill structure
iikit-core
skills/iikit-core/SKILL.md
Activation
92%This is a well-crafted skill description that clearly articulates specific capabilities and includes an explicit 'Use when...' clause with natural trigger terms. The main weakness is potential overlap with other project management or workflow skills due to generic terms, though the 'IIKit' branding provides some distinctiveness.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Initialize an IIKit project', 'check feature progress', 'select the active feature', and 'display the workflow command reference'. These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (initialize project, check progress, select feature, display commands) AND when with explicit 'Use when...' clause covering multiple trigger scenarios (starting project, running init, checking status, switching features, looking up commands). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'starting a new project', 'running init', 'checking status', 'switching between features', 'available commands and phases'. Good coverage of variations like 'init' and 'initialize'. | 3 / 3 |
Distinctiveness Conflict Risk | While 'IIKit' is a specific tool name providing some distinctiveness, terms like 'project', 'status', 'commands', and 'features' are generic and could overlap with other project management or workflow skills. The IIKit branding helps but doesn't fully eliminate conflict risk. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
100%This is an excellent skill file that demonstrates strong technical writing. It efficiently documents a complex multi-subcommand CLI tool with clear execution flows, explicit validation steps, and appropriate delegation to reference files. The use of tables for decision logic and consistent command formatting makes it highly actionable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, using tables and structured lists to convey complex workflows without unnecessary explanation. It assumes Claude understands git, bash, and project structures without explaining basic concepts. | 3 / 3 |
Actionability | Provides fully executable bash commands with exact paths, JSON output parsing instructions, and specific decision tables. Commands are copy-paste ready with Windows alternatives included. | 3 / 3 |
Workflow Clarity | Multi-step init process has clear numbered steps with explicit validation checkpoints (Step 5 validates PREMISE.md, Step 2 checks existing initialization). Each step has clear gates and auto-skip conditions documented. | 3 / 3 |
Progressive Disclosure | Well-organized with clear overview structure. References external files appropriately (prd-seeding.md, help-reference.md, templates) at one level deep with clear signaling. Complex procedures like PRD seeding are properly delegated to reference files. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.