How does the 'Reader Testing' phase work?

It uses a sub-agent with no prior context to read your draft and predict potential questions, helping identify information gaps that original authors might miss.

Does this skill integrate with Slack or Google Drive?

Yes, if you have the relevant MCP connectors enabled in Claude, this skill can pull context directly from your messaging threads and document storage.

What document types does this skill support?

The skill is optimized for structured documents including technical specifications, PRDs, RFCs, decision docs, and formal proposals.

Can I use my own company templates?

Yes, during the Context Gathering stage, you can provide a template file or link, and Claude will use it to scaffold the document structure.

How is this different from just asking Claude to write a doc?

Standard prompts often result in generic 'filler' content. This skill uses a specialized workflow to ensure deep context gathering and iterative refinement for professional-grade results.

Documentation Co-Author

Name: Documentation Co-Author
Author: macnversion

bymacnversion

0•

Learning & Documentation

Guides users through a structured, three-stage workflow to create high-quality technical documentation, proposals, and specifications.

The Documentation Co-Author skill transforms Claude into an active guide for creating complex documents like PRDs, RFCs, and technical specs. It moves beyond simple drafting by implementation a three-stage process: Context Gathering to close knowledge gaps, Refinement & Structure to brainstorm and build sections iteratively, and Reader Testing to identify blind spots using sub-agents. This skill is essential for teams that need clear, professional documentation that stands up to scrutiny from both human readers and AI systems.

Key Features

01Interactive scaffolding with artifact support for real-time visibility

02Automated 'Reader Testing' to catch logic gaps and missing context

030 GitHub stars

04Structured 3-stage workflow: Context, Refinement, and Reader Testing

05Support for external context integration via MCP (Slack, Drive, etc.)

06Iterative section-by-section brainstorming and surgical drafting

Use Cases

01Drafting comprehensive Technical Design Docs or RFCs from scratch

02Refining complex architectural decision records with iterative feedback

03Collaborative creation of Product Requirement Documents (PRDs)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add macnversion/skills doc-coauthoring

For use in Claude.ai and ChatGPT