kiro-spec-init

Generate a structured kiro spec directory with template-based spec.json and requirements.md files.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/ryu-sato/reading-web-supporter --skill kiro-spec-init-ryu-sato
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-init
Source: https://github.com/ryu-sato/reading-web-supporter/tree/main/.claude/skills/kiro-spec-init
Command: npx skills add https://github.com/ryu-sato/reading-web-supporter --skill kiro-spec-init-ryu-sato

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly initialize a new kiro specification by translating a project description into a structured spec and aligning it with templates, ensuring consistency and repeatability.

Core Features & Use Cases

  • Creates a unique .kiro/specs/[feature-name]/ directory with spec.json and requirements.md generated from templates.
  • Reuses existing discovery briefs (brief.md) to prefill descriptions and avoid unnecessary clarifying questions.
  • Validates against existing specs to prevent naming conflicts and supports automatic conflict resolution.

Quick Start

Run kiro-spec-init with your project description to generate a new specification scaffold.

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 kiro specification from a project description?

To initialize a kiro specification, you provide a project description and the tool generates a structured .kiro/specs directory with template-created spec.json and requirements.md files. It embeds the current timestamp and detected language into the generated spec scaffold.

What's the best way to prevent naming conflicts when creating new kiro specs?

To prevent naming conflicts when creating kiro specs, the initialization process checks existing .kiro/specs paths for duplicate feature names. If a conflict is detected, it supports automatic conflict resolution to ensure a unique directory is created.

Can I reuse an existing discovery brief to prefill my kiro spec requirements?

Yes, you can reuse an existing discovery brief to prefill your kiro spec. If a brief.md file is available, the tool extracts its content to prefill the project description, avoiding unnecessary clarifying questions during the spec generation process.

How does kiro spec generation handle template files and language detection?

Kiro spec generation uses templates to create spec.json and requirements.md files while automatically detecting the project language. The detected language and current timestamp are embedded directly into the generated files for consistent documentation.

Do I need a discovery brief to bootstrap a kiro spec?

No, you do not need a discovery brief to bootstrap a kiro spec. You can directly supply a project description to generate the structured spec directory, but using an existing brief.md file allows the tool to prefill the description automatically.