How does 'Reader Testing' work?

Claude simulates a fresh reader (typically via a sub-agent without prior context) to identify confusing sections or missing information that only the author would know.

Does it support collaborative editing?

While it functions as a 1-on-1 co-authoring tool with Claude, it can pull in context from team threads and existing shared documents if integrations are enabled.

What is the Doc Co-Authoring skill?

It is a specialized Claude Code capability that provides a guided, multi-stage workflow for writing structured content like technical specs, proposals, and decision docs.

What document formats does it produce?

The skill primarily works with Markdown, creating files directly in your repository or using Claude artifacts for real-time visualization.

Can I use my own templates with this skill?

Yes, the workflow specifically asks for templates or existing formats during the Context Gathering stage to ensure the output matches your organization's standards.

Doc Co-Authoring Workflow

Name: Doc Co-Authoring Workflow
Author: claudiodearaujo

byclaudiodearaujo

•

Learning & Documentation

Guides users through a structured three-stage process for collaboratively creating high-quality technical documentation and proposals.

The Doc Co-Authoring skill transforms Claude into a proactive writing partner by implementing a rigorous documentation lifecycle. It begins with deep context gathering to align project goals, proceeds through an iterative section-by-section drafting phase with integrated brainstorming, and finishes with 'Reader Testing'—where sub-agents verify clarity and catch blind spots. This workflow is specifically designed to eliminate 'AI slop' and ensure that complex documents like PRDs, RFCs, and technical specs are clear, concise, and useful for their intended human audience.

Key Features

01Three-stage structured workflow: Context, Refinement, and Testing

02Section-by-section brainstorming and iterative drafting

03Automated 'Reader Testing' via sub-agents to identify blind spots

041 GitHub stars

05Integration with external context via shared documents and messaging platforms

06Scaffold generation using Claude artifacts or local Markdown files

Use Cases

01Drafting Product Requirement Documents (PRD) with iterative stakeholder context

02Creating comprehensive Technical Design Documents (TDD) and RFCs

03Refining complex project proposals and architectural decision records (ADR)

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