doc-coauthoring

Structured documentation workflows capture all relevant context upfront through guided questions, then organize it into sections, ensuring blind spots are caught before readers encounter them. This Skill guides you through context gathering, refinement, and testing stages.

Break the writing into stages: gather all technical and business context, structure the document section-by-section with clarifying guidance, then test readability with fresh eyes to catch assumptions and ambiguities before sharing.

Use a reader-testing stage where a separate reviewer evaluates the document against your original intent, checking for missing context, unclear terminology, and accessibility gaps like missing image alt-text.

This three-stage workflow applies to any documentation type—technical specs, PRDs, proposals, RFCs, and decision documents—wherever clarity, completeness, and reader understanding matter.

Templates are optional and provided as guidance, but the core value comes from the structured three-stage process: context gathering, refinement with iterative section drafting, and reader testing.