CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/intent-integrity-kit

Closing the intent-to-code chasm - specification-driven development with BDD verification chain

95

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

iikit-bugfix

skills/iikit-bugfix/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, uses natural trigger terms users would actually say, includes an explicit 'Use when...' clause with multiple scenarios, and clearly distinguishes itself from related skills by mentioning its relationship to the specification process.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'creates a structured bugs.md record', 'generates fix tasks in tasks.md', and 'imports from or creates GitHub issues'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both what (creates bugs.md record, generates fix tasks, handles GitHub issues) AND when with explicit 'Use when...' clause covering multiple trigger scenarios (fixing bugs, reporting defects, importing GitHub issues, triaging errors).

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'bug', 'defect', 'GitHub issue', 'error', 'fixing a bug', 'triaging'. Good coverage of variations a user might naturally use when encountering this need.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused on bug reporting workflow with distinct triggers (bugs.md, GitHub issues, defects). The explicit mention of 'without running the full specification process' helps distinguish it from broader specification or task management 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 strong, well-structured skill with excellent actionability and workflow clarity. The multi-step process is clearly sequenced with validation checkpoints and error handling. Minor verbosity from repeated platform-specific command blocks and some explanatory text could be trimmed for better token efficiency.

Suggestions

Consider consolidating the repeated Unix/Windows command patterns into a single reference section or helper notation to reduce redundancy throughout the document.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundancy (e.g., repeating Unix/Windows command variants throughout, verbose step descriptions). The structure is clear but could be tightened—some explanatory text could be trimmed without losing clarity.

2 / 3

Actionability

Provides fully executable bash/PowerShell commands, specific file paths, concrete templates, and copy-paste ready code blocks. Each step has explicit commands with exact syntax and expected outputs.

3 / 3

Workflow Clarity

Excellent multi-step workflow with clear sequencing (13 numbered steps), explicit validation checkpoints (Step 4 validate feature, Step 10 verify hash), conditional branching (GitHub vs text input, TDD vs non-TDD), and error recovery paths in the error handling table.

3 / 3

Progressive Disclosure

Well-structured with clear overview, references to external templates (bugs-template.md, constitution-loading.md), and appropriate inline detail. Content is organized into logical sections without deep nesting or monolithic walls of text.

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.