Closing the intent-to-code chasm - specification-driven development with BDD verification chain
94
Quality
94%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
iikit-clarify
skills/iikit-clarify/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 (resolve ambiguities via targeted questions and option tables), names the specific artifact types it handles, and provides an explicit 'Use when' clause with six natural trigger scenarios. The description is distinctive enough to avoid conflicts with other skills due to its specific workflow and artifact focus.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'auto-detects the most recent artifact', 'asks targeted questions with option tables', 'writes answers back into the artifact's Clarifications section'. Also enumerates specific artifact types (spec, plan, checklist, testify, tasks, constitution). | 3 / 3 |
Completeness | Clearly answers both what ('Resolve ambiguities...auto-detects...asks targeted questions...writes answers back') AND when with explicit 'Use when' clause listing six specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'requirements are unclear', 'trade-off gaps', 'thresholds feel wrong', 'test scenarios are imprecise', 'task dependencies seem off', 'principles are vague'. These are natural phrases describing ambiguity situations. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on resolving ambiguities specifically in project artifacts with a defined workflow (detect artifact → ask questions → write to Clarifications section). The specific artifact types and 'Clarifications section' make it distinct from general Q&A or documentation 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 with clear workflows and appropriate progressive disclosure. The main weakness is moderate verbosity from repeated cross-platform command patterns that could be consolidated. Overall, it provides excellent guidance for a complex multi-step clarification process.
Suggestions
Consider consolidating Windows/bash command pairs into a reference file or using a single notation pattern (e.g., 'Run check-prerequisites script with --phase clarify --json') to reduce inline repetition.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy (Windows commands repeated inline for every script call) and could be tightened. It doesn't over-explain concepts Claude knows, but the repetitive cross-platform command patterns add bulk. | 2 / 3 |
Actionability | Provides fully executable bash/powershell commands, specific file paths, concrete table mappings for artifact detection, and exact commit message formats. The workflow is copy-paste ready with clear command syntax. | 3 / 3 |
Workflow Clarity | Clear numbered sequence with explicit validation steps (step 5), feedback loops (re-run prerequisites after selection), save-after-each-integration checkpoints, and explicit error handling. The testify exception is clearly documented. | 3 / 3 |
Progressive Disclosure | Well-structured with clear section headers and appropriate delegation to reference files (ambiguity-taxonomies.md, conversation-guide.md, clarification-format.md, model-recommendations.md). References are one level deep and clearly signaled. | 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.