What types of documents can I write with this skill?

It is optimized for structured content such as technical specifications, PRDs, RFCs, design docs, and formal project proposals.

Will it rewrite my entire document every time I make a change?

No, the skill uses surgical editing (str_replace) to refine specific parts of the draft, ensuring your feedback is applied precisely without losing other work.

How does the 'Reader Testing' phase work?

The skill simulates a reader with no prior context (using a sub-agent) to identify logical gaps, confusing terms, or 'blind spots' that the authors might have missed.

Can I use my existing templates with this skill?

Yes, the workflow specifically asks for templates or specific formats during the Context Gathering stage to ensure the output matches your organizational standards.

Does it pull information from my existing tools?

If enabled, the skill can use MCP integrations to pull context directly from Slack, Google Drive, SharePoint, and other connected document storage tools.

Documentation Co-Authoring Workflow

Name: Documentation Co-Authoring Workflow
Author: JamesPrial

byJamesPrial

0•

内容管理

Guides users through a structured, three-stage workflow for collaboratively drafting technical specifications, proposals, and project documentation.

The Documentation Co-Authoring skill transforms Claude into an active writing partner by implementing a rigorous three-phase process: Context Gathering, Refinement & Structure, and Reader Testing. It moves beyond simple text generation by first closing the knowledge gap between the user and AI, brainstorming section-specific content, and finally simulating a 'fresh' reader to identify blind spots. This skill is ideal for teams needing high-quality PRDs, RFCs, or technical docs that are clear, concise, and ready for stakeholder review.

主要功能

01Comprehensive context gathering via integrations like Slack and Google Drive

02Iterative surgical editing to maintain consistent style and tone

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

04Automated 'Reader Testing' to identify gaps and confusing technical jargon

050 GitHub stars

06Interactive brainstorming with 5-20 options per document section

使用场景

01Drafting technical specifications and RFCs with deep architectural context

02Polishing internal decision docs to ensure clarity for stakeholders

03Creating Product Requirement Documents (PRDs) from scattered team notes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamesprial/skills doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill