CtrlK
BlogDocsLog inGet started
Tessl Logo

tessl-labs/intent-integrity-kit

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

Overview
Skills
Evals
Files

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.