What document types does this skill support?

It is designed for any structured content, including PRDs, design docs, RFCs, technical specs, decision logs, and project proposals.

How does the Reader Testing phase improve my document?

The skill uses a sub-agent with no previous context to read your draft and flag areas that are confusing, contradictory, or missing essential background information.

Can I use my own document templates?

Yes. During the Context Gathering stage, you can provide a template file or link to a shared document for Claude to follow.

Do I have to follow the entire workflow every time?

While the workflow is recommended for high-stakes docs, you can decline the structured approach and work in a freeform style if you prefer.

Doc Co-authoring Workflow

Name: Doc Co-authoring Workflow
Author: claudiodearaujo

byclaudiodearaujo

•

Learning & Documentation

Guides users through a structured, three-stage workflow to draft, refine, and test high-quality technical documentation and proposals.

This skill transforms Claude into an expert writing partner for technical and business documentation. It follows a rigorous methodology: gathering deep context through targeted questioning, building documents section-by-section using collaborative brainstorming, and finally performing 'Reader Testing' to identify logical gaps. By simulating how a fresh reader (or another AI) would interpret the content, this skill ensures that your PRDs, RFCs, and design docs are clear, concise, and comprehensive before they reach your team.

Key Features

01Automated 'Reader Testing' via sub-agents to detect blind spots and confusion.

02Iterative section-by-section drafting with brainstorming and curation steps.

03Structured three-stage workflow: Context, Refinement, and Testing.

041 GitHub stars

05Intelligent context gathering through 5-10 targeted clarifying questions.

06Native support for creating and managing documentation artifacts and files.

Use Cases

01Refining existing documentation to ensure clarity for both human readers and AI tools.

02Creating structured project proposals and decision docs with team context.

03Drafting complex Product Requirement Documents (PRDs) and technical RFCs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add claudiodearaujo/sistema-de-narra-o-de-livro doc-coauthoring

For use in Claude.ai and ChatGPT

Download Skill