CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kiro-discovery

Entry point for new work. Determines the best action path or work decomposition (update existing spec, create new spec, mixed decomposition, or no spec needed) and refines ideas through structured dialogue.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tools/cc-sdd/templates/agents/codex-skills/skills/kiro-discovery/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.

The content is a highly actionable, well-sequenced workflow with concrete templates, per-path commands, user-confirmation checkpoints, and a viability feedback loop. Its main weakness is redundancy — re-entry rules and the write-to-disk constraint each appear twice — plus templates that could be split into a reference file to slim the main body.

DimensionReasoningScore

Conciseness

The body is dense and instructional with no explanations of concepts Claude already knows, but re-entry guidance is duplicated between Step 7's "Re-entry" section and the "Safety & Fallback" section, and "Critical Constraints" repeats Step 7's CRITICAL warning — some unnecessary repetition that could be tightened. Not a 2 because padding is limited; not a 4 because the duplication goes beyond minor.

3 / 5

Actionability

Provides fully executable, copy-paste-ready guidance: exact file paths ({{KIRO_DIR}}/specs/<feature-name>/brief.md), complete brief.md and roadmap.md templates, per-path next commands ($kiro-spec-init, $kiro-spec-batch, $kiro-spec-requirements), and specified sub-agent return formats ("findings under 200 lines", "Return only issues found, or 'No issues found'"). Concrete specifics cover the common cases for every path.

5 / 5

Workflow Clarity

A clear 8-step sequence with explicit path branching (A–E), user-confirmation checkpoints ("present the determined path... and confirm before proceeding"), a viability-check feedback loop ("If the viability check reveals issues... revisit the approach selection"), and write verification ("verify the files exist by reading them back"). Not a 5 because the read-back verification lacks an explicit recovery loop if it fails and a few checkpoints remain implicit.

4 / 5

Progressive Disclosure

No bundle files exist and none are referenced, so there are no broken or nested references; sections are well-organized (numbered steps, Critical Constraints, Safety & Fallback) and the templates are consumed exactly once at write time, making inlining defensible. Minor gap: the ~90 lines of brief/roadmap templates could arguably live in a references/ file, keeping SKILL.md as a leaner overview.

4 / 5

Total

16

/

20

Passed

Description

63%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.

The description clearly states what the skill does and enumerates the four concrete action paths, with a terse but explicit "when" ("Entry point for new work"). Its weaknesses are trigger-term coverage — missing natural phrases like "new feature" or "plan the work" — and moderate overlap risk with generic planning/ideation skills.

Suggestions

Add an explicit trigger clause with natural user phrasing, e.g. "Use when the user starts new work, proposes a new feature or idea, or asks to plan or break down a project".

Include natural synonyms users would actually say — "new feature", "idea", "plan the work", "break this down" — alongside the existing "spec" and "decomposition" terms.

Sharpen distinctiveness by naming the spec-driven workflow context earlier (e.g. "Routes spec-driven development requests...") so it is less likely to trigger for general brainstorming or planning requests.

DimensionReasoningScore

Specificity

Enumerates concrete decision outcomes — "update existing spec, create new spec, mixed decomposition, or no spec needed" — plus a second action ("refines ideas through structured dialogue"), matching the several-specific-actions-with-minor-gaps anchor. It falls short of 5 because "refines ideas through structured dialogue" is generic phrasing rather than a fully concrete capability.

4 / 5

Completeness

The "what" is clear (determines action path/decomposition and refines ideas) and a "when" is explicitly stated via "Entry point for new work", so the missing-trigger cap does not apply; however the trigger guidance is terse and could be more specific, matching the both-present-but-when-could-be-more-explicit anchor. Not a 5 because there are no concrete trigger phrases like "Use when...".

4 / 5

Trigger Term Quality

Contains some relevant keywords users might say ("new work", "spec", "decomposition") but misses common natural variations like "new feature", "idea", "plan", or "break this down", matching the some-relevant-keywords-missing-variants anchor. Not a 4 because more than just a few natural terms are absent.

3 / 5

Distinctiveness Conflict Risk

The repeated "spec" terminology carves out a niche, but the broad opening "Entry point for new work" and "refines ideas through structured dialogue" overlap with general planning/brainstorming skills, matching the somewhat-specific-but-still-overlapping anchor. Not a 4 because the overlap risk with closely related planning/ideation skills is more than minor.

3 / 5

Total

14

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

gotalab/cc-sdd

Path

tools/cc-sdd/templates/agents/codex-skills/skills/kiro-discovery/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.