kiro-spec-requirements

Generate EARS-format requirements documents for specification-driven development workflows.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-spec-requirements-j5ik2o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kiro-spec-requirements
Source: https://github.com/j5ik2o/marp-ai-base/tree/main/.agents/skills/kiro-spec-requirements
Command: npx skills add https://github.com/j5ik2o/marp-ai-base --skill kiro-spec-requirements-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing clear, testable requirements is slow and error-prone, and vague acceptance criteria cause rework later in design and implementation. This Skill generates a complete requirements document that follows EARS syntax, respects project steering context, and passes a built-in review gate before anything is written to disk. ## Core Features & Use Cases - EARS-Compliant Requirements Generation: Produces acceptance criteria in event-driven, state-driven, unwanted-behavior, optional-feature, and ubiquitous patterns, in English or Japanese based on spec.json language settings. - Built-in Review Gate: Runs mechanical and judgment-based checks (numeric IDs, EARS triggers, no implementation details) with up to two repair passes before writing requirements.md. - Context-Aware Scope Boundaries: Reads steering files, briefs, and templates to make inclusion/exclusion boundaries explicit while keeping technology choices out of requirements. - Use Case: After drafting a feature brief for a checkout service, run the Skill to produce a reviewed requirements.md with numbered requirements and EARS acceptance criteria, then proceed directly to the design phase. ## Quick Start Ask the agent to generate requirements for your spec by running the kiro-spec-requirements skill with your spec name, for example: generate requirements for the checkout-feature spec.

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 with EARS acceptance criteria?

Run the Skill with your spec name; it reads spec.json, brief.md, and steering files, then drafts requirements using EARS patterns like event-driven and state-driven criteria. The draft passes a review gate before requirements.md is written.

What is the EARS format for writing requirements?

EARS (Easy Approach to Requirements Syntax) defines patterns such as "When [event], the [system] shall [response]" for event-driven behavior and "If [trigger]" for unwanted behavior. The Skill supports both English and Japanese fixed phrases for these patterns.

Does the requirements generator support Japanese specifications?

Yes, it reads spec.json language and uses Japanese EARS phrases like "が起きたとき" and "しなければならない" when language is "ja", selecting the matching requirements template. Unsupported languages cause it to stop and ask for clarification.

Why does the Skill stop instead of writing requirements.md?

It stops when the review gate finds real scope ambiguity or contradiction, when templates or localized terminology files are missing, or when the language is undefined. It asks you to clarify rather than writing guessed requirements.

Can requirements include technology stack or architecture details?

No, requirements describe user-observable behavior only. Technology choices, API design, and architecture patterns are deferred to the design phase, and the review gate flags implementation language found in drafts.