Closing the intent-to-code chasm - specification-driven development with BDD verification chain
95
Does it follow best practices?
Validation for skill structure
iikit-03-checklist
skills/iikit-03-checklist/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 a well-crafted skill description that excels across all dimensions. It clearly specifies what the skill does (generate quality checklists with scored items linked to spec sections), uses natural trigger terms that practitioners would actually say, and includes an explicit 'Use when' clause with multiple relevant scenarios. The domain-specific terminology (FR-XXX, SC-XXX, PRD, acceptance criteria) makes it highly distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'validate requirements completeness, clarity, and consistency', 'produces scored checklist items linked to specific spec sections (FR-XXX, SC-XXX)'. Clear output format is specified. | 3 / 3 |
Completeness | Clearly answers both what ('Generate quality checklists that validate requirements...produces scored checklist items') AND when ('Use when reviewing a spec for gaps, doing a requirements review, verifying PRD quality...'). Explicit 'Use when' clause with multiple trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'spec', 'gaps', 'requirements review', 'PRD quality', 'user stories', 'acceptance criteria', 'gating before implementation'. These are terms practitioners naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on requirements/spec validation with distinct triggers like 'FR-XXX, SC-XXX', 'PRD quality', 'acceptance criteria'. Unlikely to conflict with general document or code review skills due to specific domain focus. | 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 skill with excellent workflow clarity and actionability. The multi-step process includes proper validation checkpoints, feedback loops for gap resolution, and clear completion criteria. Minor verbosity from repeated platform-specific command variants and some path redundancy prevents a perfect conciseness score.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy (e.g., Windows alternatives repeated throughout, verbose path specifications). The core instructions are clear but could be tightened by consolidating platform-specific commands. | 2 / 3 |
Actionability | Provides fully executable bash/PowerShell commands, specific file paths, concrete item structure examples with correct/wrong patterns, and exact jq commands for JSON manipulation. Copy-paste ready throughout. | 3 / 3 |
Workflow Clarity | Excellent multi-step workflow with numbered phases, explicit validation checkpoints (prerequisites check, gap resolution, remaining item validation), clear feedback loops ('If covered: check off... If genuine gap: convert'), and explicit completion criteria (100% before success). | 3 / 3 |
Progressive Disclosure | Well-structured overview with clear one-level-deep references to supporting files (constitution-loading.md, conversation-guide.md, checklist-examples.md, checklist-template.md, model-recommendations.md). Content appropriately split between main skill and reference materials. | 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.