What happens during the Reader Testing stage?

Claude simulates a fresh reader with no prior context to see if the document is clear, identifies missing information, and ensures the content is actionable for others.

Why is this better than just asking Claude to write a doc?

This workflow prevents 'AI slop' by using iterative refinement, ensuring every sentence carries weight and that all organizational context is captured before drafting begins.

How does the Doc Co-Authoring workflow trigger?

The skill triggers automatically when you mention tasks like 'write a doc', 'draft a proposal', 'create a spec', or specific document types like 'PRD' or 'RFC'.

Does this skill work with existing documentation?

Absolutely. It can read existing markdown files or use MCP integrations to pull context from tools like Google Drive, Slack, or SharePoint.

Can I use my own organization's templates?

Yes. During the Context Gathering stage, the skill specifically asks if you have a template or specific format you would like to follow.

Doc Co-Authoring Workflow

Name: Doc Co-Authoring Workflow
Author: prateek

byprateek

0•

Learning & Documentation

Guides users through a structured three-stage process to co-author high-quality documentation, technical specifications, and proposals.

The Doc Co-Authoring skill transforms Claude into an active partner for creating structured, high-impact documentation. By following a rigorous workflow—Context Gathering, Refinement & Structure, and Reader Testing—it ensures that complex ideas are captured accurately and communicated effectively. This skill helps bridge the gap between raw information and polished final drafts by asking strategic clarifying questions, brainstorming content sections, and performing simulated 'blind' reader tests to catch potential confusion before your team sees the document.

Key Features

01Deep-dive context gathering via targeted clarifying questions

02Iterative section-by-section drafting and surgical refinement

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

040 GitHub stars

05Automated document scaffolding and artifact management

06Simulated reader testing to identify blind spots and missing context

Use Cases

01Creating Product Requirement Documents (PRDs) and strategic proposals

02Writing comprehensive project post-mortems and internal team handbooks

03Drafting technical RFCs, design docs, or architectural decision records (ADRs)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add prateek/dotfiles doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill