CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kiro-validate-gap

Analyze implementation gap between requirements and existing codebase. Use when planning integration with existing systems.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-validate-gap/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured process skill with concrete file paths, commands, explicit error fallbacks, and a write-verification checkpoint. The core weakness is that the entire analytical methodology is delegated to rules/gap-analysis.md, which is absent from the provided bundle, leaving the skill's substance unverifiable; minor redundancy between the Role and Mission sections could also be trimmed.

DimensionReasoningScore

Conciseness

The body is dense with actionable process steps and avoids explaining concepts Claude already knows, but has minor redundancy — the Role ("You are a specialized skill for analyzing the implementation gap between requirements and existing codebase to inform implementation strategy") restates the Core Mission ("Analyze the gap between requirements and existing codebase to inform implementation strategy"), which itself restates the frontmatter description. This fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than a 5 where every token earns its place.

4 / 5

Actionability

Concrete, executable guidance dominates: exact paths to read ("{{KIRO_DIR}}/specs/{feature}/spec.json", "{{KIRO_DIR}}/specs/{feature}/requirements.md"), an exact write target ("save the gap analysis to {{KIRO_DIR}}/specs/{feature}/research.md"), an exact error message ("Run `/kiro-spec-requirements {feature}` first to generate requirements"), and next commands ("/kiro-spec-design {feature}"). It is not a 5 because the actual analysis methodology is wholly delegated to gap-analysis.md ("Follow gap-analysis.md framework for thorough investigation") and that file is not present in the provided bundle, leaving the core 'how' unverifiable — 'minor gaps' rather than fully self-contained coverage.

4 / 5

Workflow Clarity

A clear five-step sequence with explicit checkpoints and feedback loops: parallel research areas are identified, the write is verified ("Verify the file was written by reading it back"), and five error scenarios with fallback behavior are specified. It stops short of a 5 because Step 1 is muddled by the confusing line "Select skills for the current task even when steering/spec context is already available:" which mixes skill-selection policy into context gathering, and validation is only on the final write, not on analysis completeness.

4 / 5

Progressive Disclosure

The SKILL.md is an orchestration overview delegating the analysis framework to a single, clearly signaled, one-level-deep reference ("Read `rules/gap-analysis.md` from this skill's directory for comprehensive analysis framework"), with well-organized sections. It is not a 5 because that referenced rules file is not present in the provided bundle (no rules/, references/, scripts/, or assets/ directories exist), so the structure cannot be fully verified and the split cannot be confirmed as appropriate.

4 / 5

Total

16

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A concise, third-person description that clearly states what the skill does and gives an explicit 'Use when' trigger. Main gaps are the single-action 'what' (no enumeration of the analysis outputs) and a trigger clause narrow enough to miss natural variations like 'gap analysis' or 'brownfield'.

Suggestions

Enumerate 2-3 concrete actions in the 'what' clause, e.g., 'Analyze the implementation gap between requirements and existing codebase: identify missing capabilities, evaluate extend/new/hybrid approaches, and flag research needs. Write findings to research.md.'

Broaden the 'when' clause to include natural trigger variations: 'Use when planning integration with existing systems, estimating brownfield work, or deciding whether to extend or rebuild existing code.'

DimensionReasoningScore

Specificity

The description names the domain and a single concrete action — "Analyze implementation gap between requirements and existing codebase" — but does not enumerate what the analysis covers (missing capabilities, approach evaluation, research needs), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because no 'several specific actions' are listed, and not a 2 because the action named is concrete rather than generic.

3 / 5

Completeness

Both parts are present: what ("Analyze implementation gap between requirements and existing codebase") and when ("Use when planning integration with existing systems"). It falls short of a 5 because the 'when' clause covers only integration planning and omits other natural triggers for the same skill (e.g., brownfield work, gap analysis requests), fitting the anchor "'when' could be more explicit or specific".

4 / 5

Trigger Term Quality

Triggers like "planning integration with existing systems", "requirements", and "existing codebase" are phrases a user would plausibly say. It is not a 5 because common variations such as 'gap analysis', 'brownfield', or 'extend existing features' are missing, and not a 3 because the included keywords are natural rather than jargon-only.

4 / 5

Distinctiveness Conflict Risk

The gap-analysis framing carves a fairly clear niche distinct from code-review or design-generation skills, with only minor overlap risk with closely related spec-workflow skills. It is not a 5 because terms like 'requirements' and 'codebase' are broad enough to overlap with adjacent specification/refactoring skills.

4 / 5

Total

15

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

gotalab/cc-sdd

Path

tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-validate-gap/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.