sdd-spec-requirements

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

Updated Dec 2, 2025
One-click install
npx skills add https://github.com/qlawmarq/dotfiles-common --skill sdd-spec-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec-requirements
Source: https://github.com/qlawmarq/dotfiles-common/tree/main/skills/sdd-init/references/skills/spec-requirements
Command: npx skills add https://github.com/qlawmarq/dotfiles-common --skill sdd-spec-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of detailed, testable requirements in EARS format, transforming project descriptions into a structured requirements document.

Core Features & Use Cases

  • Automated Requirement Generation: Creates comprehensive requirements based on project descriptions and steering context.
  • EARS Format Compliance: Ensures all acceptance criteria adhere to the EARS (Event-driven, Actor, Response, State) syntax.
  • Use Case: Kickstart a new feature development by providing the project description and letting this Skill generate the initial set of requirements for review and approval.

Quick Start

Use the sdd-spec-requirements skill to generate requirements for the 'user-authentication' feature.

Frequently Asked Questions about sdd-spec-requirements

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

FAQPage Schema
How do I generate testable requirements from a project description?

You can generate testable requirements by providing your project description and steering context to an automated specification tool, which outputs structured requirements in EARS format. This ensures all acceptance criteria follow a standardized, testable syntax.

What is the EARS syntax for software requirements?

EARS is an Event-driven, Actor, Response, State syntax used to write unambiguous, testable software requirements. It structures requirements to clearly define triggers, actors, expected responses, and system states for feature specifications.

How do I start spec-driven development for a new feature?

To start spec-driven development, you define the initial feature specifications by generating a comprehensive requirements document from your project description. This creates the foundational, testable requirements needed for subsequent development phases.

Do I need steering context to generate EARS requirements?

Yes, steering context is required to generate EARS requirements. Loading project context from directories like docs/tasks/ and docs/steering/ ensures the generated requirements adhere to project constraints and specific EARS patterns.

What's the best way to structure acceptance criteria for automated testing?

Using the EARS format is the best way to structure acceptance criteria for automated testing. It transforms project descriptions into strict Event-driven, Actor, Response, and State syntax, making each requirement inherently testable.

Can I use project specifications to create initial feature requirements?

Yes, you can use existing project specifications to create initial feature requirements. The specification process analyzes your project descriptions and applies EARS patterns to output a comprehensive, structured set of requirements for review.