What problem does it solve?
Guide users through a structured, three-stage workflow for co-authoring documentation. It helps teams transfer context, refine content through iteration, and verify that the document works for readers. The skill is triggered when users mention writing documentation, proposals, technical specs, decision docs, or similar tasks.
Core Features & Use Cases
- Three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing.
- Trigger conditions: When users reference writing docs, proposals, specs, RFCs, or similar tasks.
- Stage 1 — Context Gathering: asks clarifying questions, enables a comprehensive context dump, and defines exit criteria.
- Stage 2 — Refinement & Structure: builds sections through brainstorming, editing, and gap checks with iterative refinement.
- Stage 3 — Reader Testing: tests the draft with a fresh context to surface blind spots before broad review.
- Artifacts and scaffolds: creates outlines or templates to structure the document before drafting.
Quick Start
Offer the 3-stage doc co-authoring workflow to the user. If the user accepts, begin Stage 1 (Context Gathering) and collect context through guided questions. If they decline, proceed with freeform writing.
