spec-writing

Write modular feature specifications with six sections and Mermaid diagrams.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/YuluoY/nimis --skill spec-writing-yuluoy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/YuluoY/nimis/tree/main/skills-en/spec-writing
Command: npx skills add https://github.com/YuluoY/nimis --skill spec-writing-yuluoy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Transform vague or incomplete feature requests into modular, reviewable, and acceptance-ready requirement documents so teams can implement and test with confidence. It prevents omissions, reduces back-and-forth clarification, and produces versionable artifacts suitable for PR review and TDD.

Core Features & Use Cases

  • Six-section enforcement: Produces Feature Overview, User Stories, Requirement Description, Technical Requirements, Constraints, and Test Criteria for every feature document.
  • Mermaid-first diagrams: Requires Mermaid diagrams for logic, module, flow, sequence, architecture, and ER visuals and plain-text directory trees for file structures.
  • Test matrix & priorities: Generates explicit cross-combination test matrices and assigns P0–P3 priorities to guide TDD and QA.
  • Modular output & monorepo defaults: Emits per-feature Markdown files into specs/ with monorepo defaults (apps/ + packages/) and splits multi-module requirements into separate docs.

Quick Start

Write a six-section feature spec for "guest checkout" including Mermaid flowchart for the user journey, an ER diagram for any new entities, and an explicit test combination matrix, then save it to specs/checkout/guest-checkout.md.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I write structured PRDs with user stories and acceptance criteria from vague ideas?

To write structured PRDs from vague ideas, transform incomplete feature requests into modular six-section feature specifications. This standardizes user stories, requirement descriptions, and acceptance criteria into reviewable documents for confident team implementation.

What is the best way to include visual flowcharts and ER models in feature specs?

The best way to include visual flowcharts and ER models in feature specs is using Mermaid-first diagrams. It requires plain-text Mermaid diagrams for logic, module, sequence, architecture, and ER visuals, alongside plain-text directory trees for file structures.

Can I generate requirement documents for monorepos and multi-module systems?

Yes, you can generate requirement documents for monorepos and multi-module systems. It applies monorepo defaults with apps/ and packages/ directories, splitting multi-module requirements into separate per-feature Markdown files under the specs/ directory.

How do I create a cross-combination test matrix for TDD and QA?

To create a cross-combination test matrix for TDD, generate explicit test matrices within the Test Criteria section. It automatically assigns P0–P3 priorities to guide QA and test-driven development, ensuring versionable artifacts suitable for PR review.

What are the required sections for a standardized feature specification document?

The required sections for a standardized feature specification are Feature Overview, User Stories, Requirement Description, Technical Requirements, Constraints, and Test Criteria. This six-section enforcement prevents omissions and reduces back-and-forth clarification.

Does spec-writing work for incremental feature slices and requirement reviews?

Yes, spec-writing works for incremental feature slices and requirement reviews. It transforms incomplete requests into acceptance-ready documents, making them suitable for incremental feature slicing and modular requirement reviews within versionable artifacts.