doc-coauthoring

Guide staged co-authorship of technical documents through context gathering, refinement, and reader testing.

27|4|Updated Mar 6, 2026

Search Tags:#workflow #documentation #iteration #content-creation #coauthoring #reader-testing

Ready to run

npx skills add https://github.com/skateddu/claude-code-python-setup --skill doc-coauthoring-skateddu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/skateddu/claude-code-python-setup/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/skateddu/claude-code-python-setup --skill doc-coauthoring-skateddu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured workflow for guiding users through collaborative document creation. Act as an active guide, walking users through three stages: Context Gathering, Refinement & Structure, and Reader Testing.

Core Features & Use Cases

Stage 1: Context Gathering — collect context from the user, ask clarifying questions, and establish goals for the document.
Stage 2: Refinement & Structure — iteratively build sections through brainstorming and editing, then refine with surgical edits.
Stage 3: Reader Testing — test the document with a fresh Claude instance to catch gaps and ensure readability for external readers. Trigger when user mentions writing documentation: "write a doc", "draft a proposal", "create a spec", or similar tasks. Provide a guided workflow: Context Gathering, Refinement & Structure, Reader Testing.

Quick Start

Start Stage 1: Context Gathering by asking the user for meta-context about the document (type, audience, desired impact) and any templates or constraints.

Frequently Asked Questions about doc-coauthoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I structure a collaborative document creation workflow for technical specs?▼

Structured collaborative document creation uses a staged co-authorship workflow to guide technical specs, proposals, and decision records through context gathering, iterative refinement, and reader testing. This enforces an artifact-driven process with stage prompts and validation against reader perspective.

What is the best way to co-author proposals and design docs iteratively?▼

Iterative co-authoring of proposals and design docs is best achieved through a refinement and structure stage that builds sections via brainstorming and applies surgical edits. This artifact-driven approach ensures clarity before moving to reader testing.

How does reader testing work for documentation to catch gaps?▼

Reader testing for documentation works by validating the drafted content against a fresh perspective to catch gaps and ensure readability. It tests the document with a fresh Claude instance to simulate external readers and verify clarity.

Can I use a guided workflow to draft a technical spec from scratch?▼

Yes, you can use a guided workflow to draft a technical spec from scratch by starting with context gathering. It asks clarifying questions to establish goals, then moves through iterative structure refinement and reader testing to finalize the document.

When do I need a structured co-authoring process for content creation?▼

A structured co-authoring process for content creation is needed when writing technical specs, proposals, design docs, or decision records. It coordinates context gathering, refinement, and reader testing to enforce validation and ensure external readability.