CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kiro-spec-batch

Create complete specs (requirements, design, tasks) for all features in roadmap.md using parallel sub-agent dispatch by dependency wave.

Quality

78%

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-spec-batch/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 body is a lean, highly actionable orchestration playbook with a clearly sequenced five-step workflow, explicit validation checkpoints, per-wave file verification, and a bounded remediation loop. Its main strengths are copy-paste-ready dispatch instructions and graceful failure handling; progressive disclosure is well handled by delegating phase detail to per-phase skill files.

DimensionReasoningScore

Conciseness

The body is almost purely operational instruction with no explanation of concepts Claude already knows — no filler, only file paths, dispatch rules, and error handling. Minor tightening is possible (the <background_information> success criteria partially duplicate Steps 3–4, and the display templates are illustrative), matching anchor 4 rather than the fully lean anchor 5.

4 / 5

Actionability

Guidance is fully concrete and copy-paste ready: exact paths ({{KIRO_DIR}}/specs/<feature>/brief.md), a complete verbatim sub-agent task block with exact arguments ("{feature-name} -y"), exact error/report messages, and specific fallback commands ("Run $kiro-spec-quick <feature> --auto"). This matches anchor 5's 'fully executable; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation checkpoints throughout: Step 1 halts on missing briefs with an exact message; Step 3 verifies the four files per feature after each wave and handles per-feature failure without aborting the wave; Step 4 is a true feedback loop (cross-spec review → fix sub-agents → re-run, 'max 3 remediation rounds'); Step 5 re-verifies and updates the roadmap. As a batch operation it does include validation and feedback loops, so the batch cap does not apply — anchor 5 fits.

5 / 5

Progressive Disclosure

No bundle files exist, and the skill deliberately delegates phase detail to one-level-deep, clearly signaled per-phase skills (.agents/skills/kiro-spec-init/SKILL.md, kiro-spec-requirements, kiro-spec-design, kiro-spec-tasks) instead of inlining them, keeping controller context lightweight. Anchor 4 fits because the ~165-line body is well-sectioned but the verbatim sub-agent task block is inline detail that could partly live in a reference; not 5 since some reorganization remains.

4 / 5

Total

18

/

20

Passed

Description

58%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 states a concrete, well-scoped capability with clearly named deliverables and a distinctive dependency-wave mechanism, but it entirely lacks a 'when to use' trigger clause and omits natural synonym keywords. Adding a Use-when clause and common phrasings would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to generate specs for all or multiple roadmap features at once, mentions batch spec creation, or asks to spec out the roadmap.'

Include natural synonyms users would say: 'specifications', 'generate specs', 'batch spec generation', 'spec out the roadmap'.

Clarify the trigger boundary relative to single-spec skills, e.g. 'Use for batch creation across features; for a single feature use kiro-spec-quick.'

DimensionReasoningScore

Specificity

"Create complete specs (requirements, design, tasks) for all features in roadmap.md using parallel sub-agent dispatch by dependency wave" enumerates several concrete deliverables (requirements, design, tasks files) and a concrete dispatch mechanism, matching anchor 4's 'several specific actions; minor gaps'. It falls short of anchor 5 because it is essentially one create-verb with enumerated outputs rather than multiple distinct actions.

4 / 5

Completeness

The 'what' is clear and concrete (create complete spec files for all roadmap features), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is above anchor 2 because the 'what' is specific rather than vague.

3 / 5

Trigger Term Quality

Terms like "specs", "requirements", "design", "tasks", "roadmap.md", and "dependency wave" are domain-relevant, but common natural variations users would say are missing ("specifications", "generate", "batch", "spec out the roadmap"), matching anchor 3 rather than anchor 4's 'a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

"roadmap.md", "specs (requirements, design, tasks)", and "dependency wave" carve a distinct batch-spec niche with minimal conflict risk; only minor overlap with single-feature spec-creation skills keeps it at anchor 4 rather than 5.

4 / 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-spec-batch/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.