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.

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

0131 GitHub stars

02Integration-aware context gathering from Slack, Drive, and more

03Automated 'Reader Testing' to identify gaps and blind spots

04Collaborative brainstorming generating 5-20 options per section

05Section-by-section iterative drafting with surgical refinement

06Structured 3-stage workflow: Context, Refinement, and Testing

Use Cases

01Co-authoring complex architectural decision records (ADRs) with stakeholder context

02Refining internal documentation to ensure clarity for team members without project history

03Drafting technical specifications or PRDs from raw information dumps

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ttmouse/skills doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill