Closing the intent-to-code chasm - specification-driven development with BDD verification chain
95
Does it follow best practices?
Validation for skill structure
iikit-06-analyze
skills/iikit-06-analyze/SKILL.md
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates specific validation capabilities, provides natural trigger terms developers would use, and explicitly states both what the skill does and when to use it. The description carves out a distinct niche around cross-artifact consistency checking that won't conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'checks that every spec requirement traces to tasks', 'plan tech stack matches task file paths', and 'constitution principles are satisfied across all artifacts'. These are precise, verifiable operations. | 3 / 3 |
Completeness | Clearly answers both what (validate cross-artifact consistency with three specific checks) AND when (explicit 'Use when...' clause listing four trigger scenarios: consistency check, requirements traceability, detecting conflicts, auditing before implementation). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'consistency check', 'requirements traceability', 'conflicts between design docs', 'auditing', 'spec requirement', 'tech stack'. Good coverage of terms a developer would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focusing on cross-artifact validation and requirements traceability. The specific mentions of 'spec requirement traces to tasks', 'constitution principles', and 'design docs' create a clear, unique domain unlikely to conflict with general code or document skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, highly actionable skill for cross-artifact consistency analysis. It excels at workflow clarity with explicit validation gates and progressive disclosure through well-organized references. Minor verbosity in detection passes and repeated platform-specific commands slightly reduce token efficiency, but overall the skill provides clear, executable guidance.
Suggestions
Consider consolidating Windows/bash command pairs into a single reference or using a platform detection pattern to reduce repetition
The detection passes (A-H) could be more compact by using a table format instead of prose descriptions for each category
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly efficient and avoids explaining basic concepts, but includes some redundancy (e.g., Windows alternatives repeated throughout, verbose section headers). The detection passes section could be more compact. | 2 / 3 |
Actionability | Provides fully executable bash/powershell commands, specific file paths, concrete output formats with markdown tables, exact severity classifications, and a precise health score formula. Copy-paste ready throughout. | 3 / 3 |
Workflow Clarity | Clear numbered sequence with explicit validation checkpoints (prerequisites check, checklist gate), feedback loops (re-run prerequisites after selection), and conditional branching (CRITICAL issues block progression). The 7-step process is well-defined with clear dependencies. | 3 / 3 |
Progressive Disclosure | Excellent use of references for detailed content (constitution-loading.md, conversation-guide.md, checklist-gate.md, phase-separation-rules.md, model-recommendations.md). Main skill stays focused on workflow while linking to supporting materials one level deep. | 3 / 3 |
Total | 11 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.