doc-coauthoring

Guide structured collaborative writing through context gathering, refinement, and reader testing.

3.4k|280|Updated Oct 1, 2018
One-click install
npx skills add https://github.com/callstack/react-native-testing-library --skill doc-coauthoring-callstack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/callstack/react-native-testing-library/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/callstack/react-native-testing-library --skill doc-coauthoring-callstack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, collaborative writing workflow to efficiently produce documentation, proposals, technical specs, and decision documents, ensuring context is captured, content is refined iteratively, and readers are validated.

Core Features & Use Cases

  • Context Gathering: Collects all relevant background and constraints from stakeholders to prevent scope creep.
  • Refinement & Structure: Guides iterative drafting, sectioning, and editing to build coherent, reader-friendly documents.
  • Reader Testing: Validates the document's clarity by simulating a fresh reader and surfacing gaps.
  • Artifact Support: Optional creation of structured artifacts (e.g., outlines, drafts) to accelerate collaboration.

Quick Start

  • Start the doc co-authoring workflow by saying you want to co-author a document.
  • Provide initial context and document type (e.g., "We need a technical spec for API X.").
  • Proceed through Stage 1 (Context Gathering), Stage 2 (Refinement & Structure), Stage 3 (Reader Testing) with iterative prompts, refining the draft until complete.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I co-author technical documentation with a structured workflow?

To co-author technical documentation, you initiate a structured workflow that enforces context gathering, iterative refinement, and reader testing. This process ensures all stakeholder constraints are captured before drafting begins.

What is the best way to write a technical spec while preventing scope creep?

Writing a technical spec while preventing scope creep requires an initial context gathering stage. This stage collects all relevant background and constraints from stakeholders before any drafting or refinement occurs.

How do I validate that my proposal is clear for a fresh reader?

To validate that a proposal is clear for a fresh reader, you use a reader testing stage. This simulates a new reader's perspective to surface gaps and validate the document's clarity before finalizing.

Can I generate structured artifacts like outlines when collaboratively writing docs?

Yes, you can generate structured artifacts like outlines and drafts during collaborative writing. This artifact support is optional and designed to accelerate the collaboration and iterative editing process.

How do I start the co-authoring workflow for a proposal?

To start the co-authoring workflow for a proposal, you state your intent to co-author a document and provide initial context and document type. You then proceed through the three iterative stages.

Does collaborative writing work for decision documents and technical specs?

Yes, collaborative writing works for decision documents and technical specs. The structured workflow applies to any substantial writing task requiring iterative refinement and reader validation.