spec-first:spec

Define functional requirements and acceptance criteria through a structured multi-phase workflow.

72|9|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/sunrain520/spec-first --skill spec-first-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first:spec
Source: https://github.com/sunrain520/spec-first/tree/main/skills/spec-first/03-spec
Command: npx skills add https://github.com/sunrain520/spec-first --skill spec-first-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill guides the AI through a structured process to define functional requirements (FR) and acceptance criteria (AC) for new features, ensuring clarity and completeness.

Core Features & Use Cases

  • Requirement Definition: Generates detailed FRs and ACs based on user input and project context.
  • Complexity Assessment: Adapts the process based on feature complexity (Trivial, Simple, Moderate, Complex).
  • Traceability: Integrates with the Spec-First CLI to register requirements and update traceability matrices.
  • Use Case: When a new feature idea is proposed, use this Skill to systematically break it down into actionable requirements and testable acceptance criteria, forming the foundation for design and implementation.

Quick Start

Use the spec skill to define requirements for the new user authentication feature.

Frequently Asked Questions about spec-first:spec

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

FAQPage Schema
How do I define functional requirements and acceptance criteria for a new feature?

To define functional requirements and acceptance criteria, use a structured, multi-phase workflow that breaks down feature ideas into testable specifications. This ensures comprehensive requirement coverage before moving to design and implementation.

How do I adapt requirement specification processes for different feature complexities?

Adapting requirement specification for different feature complexities involves assessing complexity levels like Trivial, Simple, Moderate, or Complex. The workflow then dynamically adjusts its execution paths and quality gates to match the required rigor.

How do I maintain traceability for functional requirements and acceptance criteria?

Maintaining traceability for functional requirements and acceptance criteria is done through CLI-driven updates. The system registers specifications and automatically updates a traceability matrix to ensure all requirements are tracked.

What is the best way to structure feature definition before starting software design?

The best way to structure feature definition before software design is using a spec-first approach. It systematically generates detailed functional requirements and acceptance criteria, establishing a solid foundation for subsequent implementation phases.

Can I use a spec-first approach for agile feature definition?

Yes, you can use a spec-first approach for agile feature definition. It guides the generation of detailed functional requirements and testable acceptance criteria based on project context, fitting seamlessly into iterative development workflows.

Do I need the Spec-First CLI to manage requirement traceability?

Yes, the Spec-First CLI is required to manage requirement traceability effectively. It integrates directly with the specification workflow to register requirements and update the traceability matrix, ensuring full lifecycle tracking.