write-docs

Create structured documentation through context gathering, iterative drafting, and reader-based validation.

Updated May 5, 2026
One-click install
npx skills add https://github.com/wachawo/claude-skills --skill write-docs-wachawo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-docs
Source: https://github.com/wachawo/claude-skills/tree/main/skills/write-docs
Command: npx skills add https://github.com/wachawo/claude-skills --skill write-docs-wachawo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the challenge of creating high-quality, professional documentation by providing a structured, iterative framework that prevents information gaps and ensures the final output is clear and effective for its intended audience.

Core Features & Use Cases

  • Context Gathering: A guided process to ensure all necessary background, constraints, and stakeholder requirements are captured before drafting begins.
  • Iterative Refinement: A section-by-section drafting approach that uses brainstorming and surgical editing to build documents with precision.
  • Reader Testing: A unique validation phase that uses a fresh AI instance to identify blind spots, ambiguities, and potential reader confusion before the document is finalized.

Quick Start

Initiate the documentation workflow by telling the AI that you need to write a new technical specification or project proposal.

Frequently Asked Questions about write-docs

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

FAQPage Schema
How do I create structured technical specifications through an iterative documentation workflow?

To create structured technical specifications through an iterative documentation workflow, you need a multi-stage process involving context gathering, section-by-section drafting, and reader-based validation to ensure clarity and prevent information gaps.

How does reader testing work when refining project proposals?

Reader testing for refining project proposals works by using a fresh AI instance to validate the document, identifying blind spots, ambiguities, and potential reader confusion before the text is finalized.

What is the best way to collaboratively draft decision documents without missing stakeholder requirements?

The best way to collaboratively draft decision documents without missing stakeholder requirements is to start with a guided context gathering phase to capture all necessary background and constraints before beginning the actual drafting.

Can I use this structured documentation workflow for surgical editing of existing technical writing?

Yes, you can use this structured documentation workflow for surgical editing of existing technical writing, as it applies an iterative refinement approach designed to build and modify documents with precision section by section.

Do I need an interactive environment to manage document state for collaborative writing?

Yes, you need an interactive environment capable of managing document state and performing iterative text refinement to facilitate the collaborative creation of structured technical specifications and project proposals.

When should I not use a multi-stage workflow for technical writing?

You should not use a multi-stage workflow for technical writing when your project only requires simple, single-draft text generation, as this structured framework is specifically built for complex documents requiring iterative refinement and reader validation.