kiro-spec-init

Scaffold spec.json and requirements.md from templates in a KIRO-managed specs directory.

3.6k|274|Updated Jul 17, 2025
One-click install
npx skills add https://github.com/gotalab/cc-sdd --skill kiro-spec-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-init
Source: https://github.com/gotalab/cc-sdd/tree/main/tools/cc-sdd/templates/agents/claude-code-skills/skills/kiro-spec-init
Command: npx skills add https://github.com/gotalab/cc-sdd --skill kiro-spec-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes friction when starting a new feature specification by generating a consistent spec folder and the initial metadata files, ensuring descriptions are complete and avoiding name collisions or missing templates.

Core Features & Use Cases

  • Prefill from Discovery: Reads an existing brief.md to pre-populate the project description and skip redundant clarification.
  • Safe Scaffolding: Generates a unique feature name, creates the spec directory, and writes spec.json and requirements.md from templates while handling naming conflicts.
  • Validation & Errors: Checks for required templates, reports missing files, and surfaces write failures or permission issues for troubleshooting.
  • Use case: Bootstrapping a new feature spec after a discovery session or converting a brief into a formal spec entry.

Quick Start

Initialize a new feature spec by running the kiro-spec-init skill with a concise project description or point it at an existing brief.md to prefill details.

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 project specification from a discovery brief?

Scaffolding a project spec creates a unique feature directory and generates spec.json and requirements.md files. It reads templates from settings/templates/specs to ensure consistent formatting and applies suffixes to enforce unique naming on conflicts.

What is the best way to avoid naming conflicts when creating feature specs?

To create a project spec you need template files located in settings/templates/specs. The skill checks for these required templates during initialization and reports missing files or write permission errors to help you troubleshoot setup issues.

Does the spec initialization process handle missing template files?

Yes, the spec initialization process validates required templates and reports missing files. It surfaces write failures and permission issues during the scaffolding process, allowing you to troubleshoot environment setup problems before generating the feature directory.

How do I convert a discovery brief into a formal feature requirement?

Converting a brief into a formal spec uses the prefill mechanism to extract the project description from brief.md. It skips redundant clarification steps and writes the structured requirements.md file directly into the newly scaffolded feature directory.