doc-coauthoring

Guide structured documentation co-authoring through context gathering, refinement, and reader testing.

18|3|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/buYoung/skills --skill doc-coauthoring-buyoung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/buYoung/skills/tree/main/skills/doc-coauthoring
Command: npx skills add https://github.com/buYoung/skills --skill doc-coauthoring-buyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guide users through a structured 3-stage workflow for co-authoring documentation - Context Gathering, Refinement & Structure, and Reader Testing. Use this skill whenever the user wants to write documentation, proposals, technical specs, decision docs, RFCs, PRDs, design docs, or any structured content. Trigger when the user mentions writing docs, drafting a proposal, creating a spec, writing up decisions, or similar documentation tasks, even if they just say "write a doc" or "let's draft something."

Core Features & Use Cases

Documents created without structured collaboration often fail to communicate effectively; this workflow closes that gap by systematically gathering context, building content section-by-section, and testing the result with a fresh perspective before sharing.

  • Structured 3-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing to ensure comprehensive coverage and stakeholder alignment.
  • Trigger-based prompts: Start the workflow when users request writing tasks or mention drafting a document, proposal, spec, RFC, or design doc.
  • Guidance & templates: Provides per-stage questions, brainstorming prompts, and review checklists to maintain quality and reduce rework.
  • Cross-document applicability: Suitable for technical specs, decision docs, RFCs, PRDs, design docs, proposals, or any structured documentation task.
  • Collaboration enablement: Facilitates structured co-authoring between users and AI, capturing context, decisions, and reader-oriented outcomes.

Quick Start

Begin with Stage 1: Context Gathering by asking 5-10 clarifying questions to capture project context before drafting a document.

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 specs and design docs with structured workflows?

To co-author technical specs and design docs, use a structured 3-stage workflow: gather context with clarifying questions, refine content section-by-section, and run reader-testing checks to ensure clarity and completeness before sharing.

What is the best way to draft an RFC or proposal from initial context gathering to final review?

The best way to draft an RFC or proposal is applying a 3-stage workflow: start with context gathering questions, proceed to per-section brainstorming and refinement, and finish with reader-testing checks to verify stakeholder alignment and coherence.

Can I use this co-authoring workflow for writing PRDs and decision documents?

Yes, you can use this co-authoring workflow for writing PRDs and decision documents. It applies to any structured content, guiding you through context gathering, refinement, and reader testing to produce clear, comprehensive documentation.

How does the reader-testing stage work when finalizing documentation?

The reader-testing stage works by applying review checks to finalized documentation to ensure clarity, coherence, and completeness. It tests the result with a fresh perspective to verify effective communication before the document is shared.

Do I need any specific templates or dependencies to start drafting a structured document?

You do not need specific dependencies to start drafting a structured document. The workflow itself provides the necessary per-stage questions, brainstorming prompts, and review checklists to guide the co-authoring process from start to finish.