What problem does it solve? Long-form documents like specs, proposals, and decision docs often fail not because of grammar but because of missing context, weak structure, or unclear reader expectations. This Skill provides a staged workflow that gathers context, scaffolds the document, drafts section by section, and validates the result with a cold-reader test before handoff. ## Core Features & Use Cases - Context Gathering: Collects document type, audience, target decision, constraints, and source material, then asks focused clarifying questions before drafting. - Scaffolding and Section Drafting: Creates a local Markdown scaffold with placeholders, then drafts each section through a clarify-brainstorm-curate-draft-refine loop. - Cold-Reader Test: Generates realistic reader questions and checks whether a fresh reader can answer them from the document alone, fixing gaps iteratively. - Use Case: A product manager needs an RFC for a new API design. The Skill interviews them about the problem and audience, builds a section scaffold, drafts each section collaboratively, and runs a reader test so reviewers can understand the proposal without extra explanation. ## Quick Start Use the doc-coauthoring skill to help me plan and draft a decision document for migrating our service to a new database, section by section.
