spec-doc

Convert Clarify Agent requirement summaries into structured Markdown specification documents.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/CloudyWing/ai-dotfiles --skill spec-doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-doc
Source: https://github.com/CloudyWing/ai-dotfiles/tree/main/skills/spec-doc
Command: npx skills add https://github.com/CloudyWing/ai-dotfiles --skill spec-doc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts informal or summarized requirement notes into a structured, review-ready development requirements specification so engineering and product teams can align on scope, acceptance, and implementation details.

Core Features & Use Cases

  • Structured Transformation: Extracts background, user stories, functional and non-functional requirements, system boundaries, assumptions, open issues, and acceptance criteria into a clear document.
  • Merge-safe Output: Writes in merge mode to an on-disk Markdown file to avoid overwriting and preserve existing content when applicable.
  • Use Case: After Clarify Agent produces a requirement summary for a new feature, generate a Traditional Chinese specification document for sprint planning and cross-team review.

Quick Start

Use the spec-doc skill to generate a developer-facing requirements specification from the Clarify Agent's latest requirement summary.

Frequently Asked Questions about spec-doc

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

FAQPage Schema
How do I convert requirement summaries into developer-ready specs?

To convert requirement summaries into developer-ready specs, you can use a structured transformation process that extracts background, user stories, and functional requirements into a review-ready Markdown document. This ensures engineering and product teams align on scope and implementation details.

What should be included in functional and non-functional requirements documentation?

Functional and non-functional requirements documentation should include background, user stories, system boundaries, assumptions, open issues, and verifiable acceptance criteria. Structuring these elements clearly ensures engineering and product teams can align on scope and implementation details.

How do I generate Traditional Chinese user stories and acceptance criteria for sprint planning?

You can generate Traditional Chinese user stories and acceptance criteria by applying a structured transformation to requirement summaries. This produces a localized specification document containing verifiable acceptance criteria, which is ideal for cross-team sprint planning and review.

Does writing specification documents in merge mode prevent overwriting existing Markdown content?

Yes, writing specification documents in merge mode prevents overwriting existing content. It outputs to an on-disk Markdown file while preserving applicable existing text, ensuring safe integration during collaborative drafting and review workflows.

Can I use a Clarify Agent summary as input for drafting a development requirements specification?

Yes, you can use a Clarify Agent summary or the first chapter of a design.md file as input for drafting a development requirements specification. The process transforms these informal requirement notes into a structured, review-ready document.

What is the best way to structure open issues and system boundaries in a development spec?

The best way to structure open issues and system boundaries in a development spec is to extract them into dedicated sections within a Markdown file. Separating these elements from functional requirements clarifies scope constraints and highlights unresolved questions for cross-team review.