kiro-specs

Generate requirements, design, and task documents in the .kiro/specs workflow.

4|2|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/PeterFile/my-common-skills --skill kiro-specs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-specs
Source: https://github.com/PeterFile/my-common-skills/tree/main/kiro-specs
Command: npx skills add https://github.com/PeterFile/my-common-skills --skill kiro-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Kiro specs provide a structured, repeatable way to capture ideas as formal, versioned artifacts (requirements, design, and task plans) that teams can review, approve, and execute.

Core Features & Use Cases

  • Generate a Requirements document at .kiro/specs/{feature-name}/requirements.md with user stories and EARS acceptance criteria.
  • Produce a Design document at .kiro/specs/{feature-name}/design.md detailing architecture, components, data models, and correctness properties.
  • Create a Tasks document at .kiro/specs/{feature-name}/tasks.md with a clear, test-driven implementation plan.
  • Enforce explicit phase approvals before advancing to the next stage, ensuring alignment and traceability.

Quick Start

Start a new spec by naming a feature (e.g., "user-authentication"). Kiro will scaffold the spec directory and generate the three core documents, ready for review and iterative refinement.

Frequently Asked Questions about kiro-specs

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

FAQPage Schema
How do I turn feature ideas into structured requirements and design documents?

To turn ideas into structured requirements and design documents, you can generate Kiro spec artifacts. This process scaffolds requirements.md, design.md, and tasks.md files with user stories, architecture details, and test-driven implementation plans.

What is the best way to create traceable task lists from software requirements?

Creating traceable task lists from software requirements is best handled by generating a tasks.md document within a Kiro spec. This approach produces a clear, test-driven implementation plan that aligns directly with your approved requirements and design.

How does the EARS format work for writing software acceptance criteria?

The EARS format for software acceptance criteria works by structuring user stories within a requirements.md document. It captures specific conditions and system responses to ensure formal, testable validation rules for feature design.

Can I enforce approval steps before moving from design to task planning?

Yes, you can enforce approval steps before moving from design to task planning. The Kiro specs workflow enforces explicit phase approvals before advancing to the next stage, ensuring team alignment and artifact traceability.

Do I need a specific directory structure for software design and task documentation?

You need a specific directory structure for software design and task documentation, specifically the .kiro/specs/{feature-name}/ path. This structure organizes your requirements.md, design.md, and tasks.md artifacts for iterative review.