spec-writing

Generate formal SPEC and US documents from stakeholder requirements.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dlddu/claude-agent --skill spec-writing-dlddu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/dlddu/claude-agent/tree/main/.claude/skills/spec-writing
Command: npx skills add https://github.com/dlddu/claude-agent --skill spec-writing-dlddu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill converts vague requirements into precise, shareable artifacts by automatically generating formal specifications and user stories, ensuring traceability from intent to implementation.

Core Features & Use Cases

  • SPEC generation: Creates structured SPEC documents with metadata and sections for functional and non-functional requirements.
  • User story creation: Produces end-user-focused stories aligned to the SPEC with acceptance criteria.
  • Traceability: Builds a bidirectional traceability matrix linking requirements, specs, and stories for auditability.
  • Templates & consistency: Applies standardized frontmatter and documentation templates to guarantee consistency across artifacts.

Quick Start

Provide the feature requirements in a concise brief. The skill will generate SPEC-{번호} and US-{번호} documents with appropriate metadata and templates.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I convert stakeholder requirements into formal specifications and user stories?

To convert stakeholder requirements into formal specifications and user stories, provide a concise brief of the feature requirements. The system then analyzes the input and automatically generates structured SPEC documents with functional and non-functional requirements, alongside end-user-focused stories with acceptance criteria.

What is a bidirectional traceability matrix in requirements documentation?

A bidirectional traceability matrix in requirements documentation links requirements, specs, and stories for auditability. It ensures traceability from initial intent to implementation by mapping generated SPEC and user story artifacts back to their originating stakeholder needs.

Can I use frontmatter templates to standardize SPEC and user story documents?

Yes, you can use frontmatter templates to standardize SPEC and user story documents. The system applies a structured frontmatter-based format containing metadata like name and description, guaranteeing consistency across all generated functional, non-functional, and traceability artifacts.

Does generating user stories from requirements automatically include acceptance criteria?

Generating user stories from requirements does automatically include acceptance criteria. The process produces end-user-focused stories aligned with the formal specification, ensuring each generated US document contains the necessary criteria to validate implementation against the original intent.

What is the best way to structure functional and non-functional requirements for product discovery?

The best way to structure functional and non-functional requirements for product discovery is using standardized documentation templates. Applying a formal SPEC format with dedicated sections for FR and NFR ensures precise, shareable artifacts that maintain consistency across the refinement process.

When do I need to generate SPEC documents during the requirements refinement process?

You need to generate SPEC documents during the requirements refinement process when converting vague stakeholder needs into precise, shareable artifacts. This occurs during product discovery to enforce structure and ensure bidirectional traceability from intent to implementation.