writing-skill

Generate structured technical documentation with objectives, steps, and verification criteria.

1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/nushey/sdd-flow --skill writing-skill-nushey
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-skill
Source: https://github.com/nushey/sdd-flow/tree/main/skills/writing-skill
Command: npx skills add https://github.com/nushey/sdd-flow --skill writing-skill-nushey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps prevent vague, incomplete, or hard-to-review technical plans by enforcing objective-first structure, hierarchical clarity, and explicit acceptance criteria.

Core Features & Use Cases

  • Hierarchical document structure using Markdown headings for clear scope and navigation.
  • Actionable, objective-first planning that turns intentions into imperative steps.
  • Verification requirements that ensure every plan includes a dedicated "How to verify" or measurable acceptance criteria.
  • Use Case: Produce a design document for a feature change and a task list for implementation that can be checked reliably by others.

Quick Start

Use writing-skill to draft a structured plan or design document with an objective, hierarchical sections, atomic steps, and a clear how-to-verify checklist.

Frequently Asked Questions about writing-skill

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

FAQPage Schema
How do I write technical specifications with clear acceptance criteria?

Writing technical specifications requires hierarchical Markdown headings, imperative implementation steps, and a dedicated verification section to enforce measurable acceptance criteria. This approach eliminates ambiguity by structuring goals, prerequisites, and explicit verification checklists for objective-driven execution.

What is the best way to structure a design document for implementation planning?

The best way to structure a design document is using hierarchical Markdown headings that separate scope, goals, prerequisites, and implementation steps. This hierarchical clarity turns intentions into actionable, imperative steps and ensures the plan can be reliably checked by others during execution.

How do I create an implementation plan that includes verification requirements?

Creating an implementation plan with verification requirements involves defining objective-first sections for goals and atomic steps, followed by an explicit how-to-verify checklist. This enforces measurable acceptance criteria and ensures the resulting task list can be reliably reviewed by others.

Why does my technical writing lack hierarchical clarity for reviewers?

Technical writing lacks hierarchical clarity when it misses objective-first structuring and explicit acceptance criteria. Enforcing clear Markdown sections for goals, prerequisites, atomic steps, and verification ensures implementation plans are unambiguous and can be reliably checked by reviewers.

Can I use Markdown structure for generating task lists with acceptance criteria?

Yes, Markdown structure supports generating task lists by using hierarchical headings to organize scope and atomic imperative steps. This structure explicitly accommodates acceptance criteria by requiring a dedicated verification section, ensuring the generated task list fits objective-driven execution workflows.