Closing the intent-to-code chasm - specification-driven development with BDD verification chain
95
Does it follow best practices?
Validation for skill structure
iikit-00-constitution
skills/iikit-00-constitution/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 provides specific concrete actions, includes natural trigger terms developers would use, explicitly addresses both what the skill does and when to use it, and carves out a distinct niche around project governance documentation.
| 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 on CONSTITUTION.md and project governance. The specific file type and governance-focused triggers (TDD policy, review requirements, quality gates) make it distinct from general documentation or coding 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 skill with excellent actionability and workflow clarity. The 13-step execution flow provides clear sequencing with validation checkpoints and error recovery. Minor verbosity in Windows alternatives and some explanatory text could be trimmed, but overall the skill efficiently guides Claude through a complex constitution creation process.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some redundancy (e.g., Windows alternatives repeated, verbose bash command explanations). The scope section's 'MUST NOT contain' list could be trimmed since Claude understands phase separation from the reference link. | 2 / 3 |
Actionability | Provides fully executable bash commands, specific file paths, concrete validation scripts, and copy-paste ready code blocks. Each step has explicit commands with actual script paths and jq operations. | 3 / 3 |
Workflow Clarity | Clear 13-step sequence with explicit validation checkpoints (steps 6-7), error handling in prerequisites, feedback loops for phase separation violations ('Auto-fix violations, re-validate until clean'), and conditional branching for missing files. | 3 / 3 |
Progressive Disclosure | Well-structured with clear references to external files (templates, references) that are one level deep and clearly signaled with relative paths. Main content stays focused on workflow while detailed templates and rules are appropriately externalized. | 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.