skills.rest
dougdliu
dougdliuCOMMUNITY
Explore all skills by this author →
GitHub

doc-coauthoring

Guide structured documentation workflows through context gathering, refinement, and reader testing.

Updated May 8, 2026
Search Tags:#workflow#documentation#iteration#coauthoring#reader-testing#stage-management
One-click install
npx skills add https://github.com/dougdliu/FRC_AI_Mega_Project --skill doc-coauthoring-dougdliu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/dougdliu/FRC_AI_Mega_Project/tree/main/skills/anthropic/doc-coauthoring
Command: npx skills add https://github.com/dougdliu/FRC_AI_Mega_Project --skill doc-coauthoring-dougdliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, collaborative workflow for creating documentation. It helps teams transfer context, iteratively refine content, and verify readability so readers can understand the final docs without ambiguity.

Core Features & Use Cases

  • Context Gathering: Collects all relevant information from stakeholders and sources to shape the document.
  • Refinement & Structure: Builds sections iteratively with clarifying questions, brainstorming options, and surgical edits.
  • Reader Testing: Validates the document with a fresh reviewer to uncover gaps and improve clarity.
  • Stage-based workflow: Guides users through three stages (Context Gathering, Refinement & Structure, Reader Testing) and toggles between drafting and evaluation to ensure quality.

Quick Start

Begin Stage 1 by prompting the user for context, questions, and initial dumps, then proceed to Stage 2 when ready.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is a structured co-authoring workflow for documentation?▼

Co-authoring documentation involves a stage-based process of context gathering, iterative refinement, and reader testing to ensure stakeholders collaboratively produce clear, unambiguous final docs.

How do I write a PRD or design doc collaboratively with stakeholders?▼

Begin by prompting stakeholders for context, questions, and initial information dumps. Then iteratively build sections using clarifying questions and surgical edits before proceeding to final validation.

What is the best way to test documentation readability before publishing?▼

Reader testing validates the draft with a fresh reviewer to uncover gaps and improve clarity, ensuring the final documentation is understood without ambiguity before publishing.

Does this collaborative documentation workflow work for proposals and decision docs?▼

Yes, the workflow applies to writing PRDs, design docs, decision docs, and proposals, ensuring context transfer and iterative refinement across various documentation formats.

How do I manage iterative refinement when writing technical documentation?▼

Iterative refinement builds document sections progressively using clarifying questions, brainstorming options, and surgical edits, toggling between drafting and evaluation stages to ensure quality.

Related Skills

Explore More Content & Communication Skills→
mutsumi-yamamotomutsumi-yamamoto

data-context

Detect input types, profile data, extract document information, and update analysis_context.md.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

publishing

Format and distribute finalized content to publishing platforms with scheduling and verification.

Official
Intermediate
silvarojasdiegoarturo91silvarojasdiegoarturo91

triage

Classify project issues into categories and manage their statuses.

Community
Intermediate
AlenryuichiAlenryuichi
20

doc-coauthoring

Guide a three-stage workflow for collaborative documentation drafting and validation.

Community
Advanced