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-00-constitution
skills/iikit-00-constitution/SKILL.md
Activation
100%This is a well-crafted skill description that excels across all dimensions. It provides specific concrete actions, includes natural trigger terms developers would use, explicitly states both what the skill does and when to use it, and carves out a distinct niche around project governance documentation that won't conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Create or update a CONSTITUTION.md', 'defines project governance', 'establishes coding standards, quality gates, TDD policy, review requirements, and non-negotiable development principles with versioned amendment tracking'. | 3 / 3 |
Completeness | Clearly answers both what ('Create or update a CONSTITUTION.md that defines project governance...') and when ('Use when defining project rules, setting up coding standards, establishing quality gates, configuring TDD requirements, or creating non-negotiable development principles'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'project rules', 'coding standards', 'quality gates', 'TDD requirements', 'development principles'. These are terms developers naturally use when setting up project governance. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on CONSTITUTION.md and project governance documents. The specific file type and governance-focused terminology (TDD policy, review requirements, amendment tracking) make it unlikely to conflict with general coding or documentation skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%This is a well-crafted skill that demonstrates excellent structure and actionability. It provides clear, executable guidance with proper validation checkpoints, maintains appropriate separation of concerns through well-signaled references, and respects token efficiency by assuming Claude's competence throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding explanations of concepts Claude already knows. Every section serves a purpose with no padding or unnecessary context about what constitutions are or why governance matters. | 3 / 3 |
Actionability | Provides concrete, executable commands (bash scripts, git commands), specific file paths, and clear validation steps. The workflow includes copy-paste ready commands and explicit error handling paths. | 3 / 3 |
Workflow Clarity | Clear numbered sequence with explicit validation checkpoints (prerequisites check, consistency check, phase separation validation). Includes feedback loops for validation failures and clear error recovery paths ('If FAIL... show details, suggest re-running'). | 3 / 3 |
Progressive Disclosure | Well-structured with clear references to external files (templates, references) that are one level deep and clearly signaled. Content is appropriately split between the skill overview and referenced materials like phase-separation-rules.md and templates. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.