What problem does it solve? Writing documentation, proposals, and technical specs alone often produces docs that make sense to the author but confuse readers. This Skill structures co-authoring into three stages so context is fully transferred, each section is deliberately refined, and blind spots are caught before others read the doc. ## Core Features & Use Cases - Context Gathering: Collects background, audience, constraints, and organizational context through structured questions and info dumps, optionally pulling from connected tools like Slack or Google Drive. - Section-by-Section Refinement: Brainstorms 5-20 options per section, curates them with the user, drafts into an artifact or markdown file, and iterates with surgical edits. - Reader Testing: Tests the finished doc with a fresh Claude instance (sub-agent or new conversation) to expose ambiguity, false assumptions, and contradictions. - Use Case: Draft a decision doc for a technical migration: dump your context, build each section through curated brainstorming, then verify a fresh reader can answer realistic questions about the doc. ## Quick Start Ask Claude to help you write a design doc or proposal using the doc-coauthoring workflow and answer its initial context questions.
