kiro-spec-init

Initialize spec-driven development specifications through guided triage and workflow selection.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-init-scapia-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-init
Source: https://github.com/scapia-oss/compass/tree/main/tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-spec-init
Command: npx skills add https://github.com/scapia-oss/compass --skill kiro-spec-init-scapia-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Starting a new feature or bugfix without structure leads to vague requirements and lost context. This Skill turns a rough project description into a properly scoped, categorized specification with the right workflow, artifacts, and commit policy before any code is written. ## Core Features & Use Cases - Triage Analysis: Scans the codebase with Grep and Glob to estimate blast radius, then recommends skipping SDD, a single spec, or a multi-spec breakdown. - Guided Configuration: Uses structured questions to classify work as feature, bugfix, tech-debt, or chore, and to select workflow (requirements-first vs design-first), design artifacts (HLD, LLD, research), and commit policy. - Spec Scaffolding: Creates a dated, categorized spec directory under .kiro/specs/ with pruned spec.json, requirements or bugfix templates, command tracking, and plugin version stamping. - Use Case: Run it with a description like "Add webhook support for payment events" and receive a triage report, a recommended spec type, and a fully initialized spec directory ready for requirements gathering. ## Quick Start Ask the AI to initialize a new spec by describing your idea, for example: initialize a spec for adding dark mode toggle to the settings page.

Frequently Asked Questions about kiro-spec-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize a new spec for a feature in Claude Code?

Run the spec initialization command with a project description, such as "/kiro-spec-init Add user notifications". The skill triages the request, asks guided questions about work type and workflow, then creates the spec directory and files.

What is triage analysis in spec-driven development?

Triage analysis scans your description and codebase to estimate scope, affected files, and risk. It recommends skipping SDD for trivial changes, creating a single spec, or splitting work into multiple specs, and can be bypassed with the --no-triage flag.

Can I create a bugfix spec instead of a full feature spec?

Yes. Selecting "Fix a bug" during setup records spec_type as bugfix and uses a streamlined path with current behavior, expected behavior, and unchanged behavior sections. Design phases are skipped automatically and unchanged behaviors become regression tests.

What happens if I run spec init without a description?

The skill stops immediately and shows a missing input message with usage examples. Descriptions under 10 characters or too vague trigger a request for more context before any files are created.

Where are the generated spec files stored?

Specs are written under .kiro/specs/ in a category subdirectory (features, bugs, tech-debt, or chores) with a date-prefixed folder like 2026-05-27-webhook-support. Each contains spec.json plus requirements.md or bugfix.md from templates.