Closing the intent-to-code chasm - specification-driven development with BDD verification chain
95
Does it follow best practices?
Validation for skill structure
iikit-08-taskstoissues
skills/iikit-08-taskstoissues/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 clearly defines its purpose (converting tasks.md to GitHub Issues) with specific capabilities (labels, dependencies, project boards, assignments). It includes an explicit 'Use when...' clause with natural trigger terms and has a distinct enough scope to avoid conflicts with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Convert tasks from tasks.md into GitHub Issues', 'with labels and dependencies', 'exporting work items', 'setting up project boards', 'assigning tasks to team members'. | 3 / 3 |
Completeness | Clearly answers both what ('Convert tasks from tasks.md into GitHub Issues with labels and dependencies') and when ('Use when exporting work items to GitHub, setting up project boards, or assigning tasks to team members'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'tasks.md', 'GitHub Issues', 'labels', 'dependencies', 'project boards', 'assigning tasks', 'team members', 'exporting work items'. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused on tasks.md to GitHub Issues conversion with specific triggers like 'GitHub Issues', 'project boards', and 'tasks.md' that are unlikely to conflict with general task management or other GitHub skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality skill that efficiently guides Claude through a complex multi-step workflow of converting tasks to GitHub issues. It excels at providing concrete commands, clear validation checkpoints, and explicit error handling. The parallel task dispatch pattern and dependency linking are well-specified with appropriate safeguards.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, assuming Claude's competence with Git, GitHub CLI, and task parsing. No unnecessary explanations of basic concepts; every section serves a clear purpose. | 3 / 3 |
Actionability | Provides concrete, executable bash/PowerShell commands throughout, specific title formats, template references, and exact gh CLI syntax. The parallel task dispatch pattern is clearly specified with explicit instructions. | 3 / 3 |
Workflow Clarity | Clear numbered sequence with explicit validation checkpoints (GitHub remote validation, prerequisite checks, verify subagent returns). Error handling table provides explicit recovery paths for partial failures. | 3 / 3 |
Progressive Disclosure | Well-structured with clear sections. References external files appropriately (conversation-guide.md, issue-body-template.md) at one level deep with clear signaling. Content is appropriately split between overview and referenced materials. | 3 / 3 |
Total | 12 / 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.