Does it overwrite my existing files?

No, it uses surgical edits and section-by-section updates to refine content, allowing you to maintain control over the document's evolution.

What document types does this skill support?

It is ideal for technical specs, PRDs, decision docs (ADRs), RFCs, proposals, and any structured professional documentation.

How does the 'Reader Testing' stage work?

It simulates a reader with no prior context to review the draft, identifying gaps, confusing terminology, and questions that a fresh audience might have.

Can I use my own internal documentation templates?

Yes, the workflow specifically asks for templates or format constraints during the Context Gathering phase to ensure the output matches your requirements.

Can it access my team's communication tools?

Yes, if you have MCP servers or connectors enabled for tools like Slack or Google Drive, the skill can pull in relevant context directly.

Doc Co-Authoring Workflow

Name: Doc Co-Authoring Workflow
Author: ttmouse

byttmouse

•

Learning & Documentation

Guides users through a structured three-stage workflow to collaboratively draft, refine, and test high-quality technical documentation and proposals.

About

This skill transforms Claude into an expert writing partner for technical documentation, proposals, and specifications. By following a rigorous three-phase process—Context Gathering, Refinement & Structure, and Reader Testing—it ensures that documents are comprehensive, well-structured, and clear to outside readers. It leverages iterative brainstorming for each section and even simulates 'fresh eye' testing to identify blind spots, helping teams move from initial ideas to polished, production-ready documentation efficiently.

Key Features

31 GitHub stars
Integration-aware context gathering from Slack, Drive, and more
Automated 'Reader Testing' to identify gaps and blind spots
Collaborative brainstorming generating 5-20 options per section
Section-by-section iterative drafting with surgical refinement
Structured 3-stage workflow: Context, Refinement, and Testing

Use Cases

Co-authoring complex architectural decision records (ADRs) with stakeholder context
Refining internal documentation to ensure clarity for team members without project history
Drafting technical specifications or PRDs from raw information dumps

About

Key Features

31 GitHub stars
Integration-aware context gathering from Slack, Drive, and more
Automated 'Reader Testing' to identify gaps and blind spots
Collaborative brainstorming generating 5-20 options per section
Section-by-section iterative drafting with surgical refinement
Structured 3-stage workflow: Context, Refinement, and Testing

Use Cases

Co-authoring complex architectural decision records (ADRs) with stakeholder context
Refining internal documentation to ensure clarity for team members without project history
Drafting technical specifications or PRDs from raw information dumps