kiro-spec-requirements

Generate EARS-format requirements documents from project descriptions and steering context.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Turning a rough project idea into clear, testable requirements is slow and error-prone, and AI-generated requirements often mix in implementation details or miss scope boundaries. This Skill produces structured requirements documents in EARS format that stay aligned with your project's steering context and record decisions and learnings for future sessions. ## Core Features & Use Cases - EARS Requirements Generation: Creates requirements with acceptance criteria written in EARS syntax, grouped into logical requirement areas with explicit inclusion and exclusion boundaries. - Lifecycle-Aware Routing: Reads spec.json workflow and artifact toggles to skip disabled phases, handle bugfix analysis mode, and respect design-first workflows before writing anything. - Review Gate and Feedback Capture: Runs a bounded requirements review gate before writing the file, and synchronously records directional user corrections as learnings and architectural choices as decisions. - Use Case: After running discovery for a new notifications feature, invoke this Skill to produce a requirements.md with numbered requirements, EARS acceptance criteria, and updated spec metadata, then get routed to the design phase. ## Quick Start Ask the assistant to generate requirements for your feature by running the kiro-spec-requirements skill with your feature name after discovery has created the spec directory.

Frequently Asked Questions about kiro-spec-requirements

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

FAQPage Schema
How do I generate requirements in EARS format for a new feature?

Run the kiro-spec-requirements skill with your feature name after discovery has created the spec directory. It reads the project description and steering context, drafts EARS acceptance criteria, runs a review gate, and writes requirements.md only after the gate passes.

What is the EARS format for writing acceptance criteria?

EARS (Easy Approach to Requirements Syntax) structures acceptance criteria as event-driven or state-driven statements with a clear subject and observable response. The skill loads its ears-format.md rules and applies them to every acceptance criterion it generates.

Can requirements generation handle bugfix specs instead of features?

Yes. When spec.json sets spec_type to bugfix, the skill switches to bugfix analysis mode and writes bugfix.md with Current Behavior, Expected Behavior, and Unchanged Behavior sections. Complex bugfixes automatically enable a design review gate.

Why did the skill skip requirements generation for my spec?

The skill self-skips when spec.json disables both the requirements and bugfix_analysis artifacts, or when a design-first workflow has no approved design yet. It prints the computed next step from lifecycle-navigation rules instead of writing files.

Does the skill keep requirements free of implementation details?

Yes. It enforces a WHAT-not-HOW scope: acceptance criteria must describe user-observable behavior without naming technologies, architecture, or data models. Technology choices are deferred to the design phase.