What problem does it solve? Writing documentation, proposals, and specs alone often produces docs that make sense to the author but confuse readers. This Skill structures the co-authoring process so context is fully transferred, each section is deliberately refined, and the finished doc is verified against a fresh reader before it ships. ## Core Features & Use Cases - Three-Stage Workflow: Context Gathering (info dumps plus clarifying questions), Refinement & Structure (section-by-section brainstorming, curation, and surgical edits), and Reader Testing (cold-reader validation with a fresh agent). - Environment-Aware Tooling: Uses artifacts (create_file/str_replace) on claude.ai or file tools (Write/Edit/Read) in Claude Code, and MCP connectors to pull context from Slack, Google Drive, or SharePoint. - Blind-Spot Detection: Spawns a subagent with only the document text to answer predicted reader questions and flag ambiguity, false assumptions, and contradictions. - Use Case: Draft a decision doc for a migration plan — dump your context, curate brainstormed options per section, then let a fresh Claude instance verify the doc stands on its own before sharing it with the team. ## Quick Start Ask the assistant to guide you through the doc co-authoring workflow to draft a design doc, starting with context gathering.
