What types of documents is this skill best for?

It is optimized for structured content like technical specs, decision records, user manuals, and any document where clarity and audience understanding are critical.

How does it handle document edits?

It prioritizes 'surgical edits' using targeted changes rather than reprinting entire files, which maintains consistency and speeds up the iteration process.

How does the reader testing stage work?

It uses sub-agents to read the document 'cold' as the target audience, identifying gaps, false assumptions, or confusing sections that need clarification.

Can I skip stages in the workflow?

Yes, the skill is designed to respect user agency, allowing you to skip, combine, or work in a freeform style whenever you prefer.

Does it provide templates for common documents?

Yes, it includes built-in structures for Technical Specifications, Decision Documents (ADRs), and detailed User Guides.

Document Co-Authoring

Name: Document Co-Authoring
Author: jawhnycooke

byjawhnycooke

•

Content Management

Guides the collaborative creation of high-quality technical documents and specifications through a structured three-stage workflow.

This skill transforms Claude into a sophisticated writing partner for technical and professional documentation. It implements a rigorous three-phase methodology: gathering deep context through meta-questions, iteratively building the document section-by-section with a focus on structural integrity, and finally subjecting the draft to automated 'reader testing' via sub-agents to identify ambiguities. Whether drafting technical specifications, Architecture Decision Records (ADRs), or user guides, this workflow ensures content is clear, well-structured, and fully addresses the target audience's needs without the typical pitfalls of generic AI-generated content.

Key Features

01Automated 'Reader Testing' using sub-agents to simulate target audiences

02Pre-built templates for Tech Specs, Decision Records, and User Guides

03Meta-questioning framework to close knowledge gaps before writing

04Iterative section-by-section drafting with surgical string-replacement edits

054 GitHub stars

06Three-stage workflow: Context Gathering, Refinement, and Reader Testing

Use Cases

01Drafting complex technical specifications and architecture proposals

02Creating comprehensive user documentation and developer guides

03Preparing Architecture Decision Records (ADRs) and project pitches

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jawhnycooke/claude-plugins doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill