doc-coauthoring

Guide structured three-stage co-authoring for technical documents.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/yibozhong/skills --skill doc-coauthoring-yibozhong
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/yibozhong/skills/tree/main/doc-coauthoring
Command: npx skills add https://github.com/yibozhong/skills --skill doc-coauthoring-yibozhong

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow guides users through a structured three-stage process to co-author documentation: Context Gathering, Refinement & Structure, and Reader Testing, improving clarity, alignment, and quality with collaborative iteration.

Core Features & Use Cases

  • Structured three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing.
  • Supports documents such as technical specs, proposals, design docs, and decision logs.
  • Facilitates efficient collaboration by capturing context, iterating content, and validating readability with a reader test.

Quick Start

Run Stage 1: Context Gathering with the user, then Stage 2 and Stage 3 if needed.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is the best way to structure collaborative technical spec writing?

Structured collaborative technical spec writing benefits from a three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. This process improves clarity, alignment, and quality by validating readability through iterative collaboration.

How do I co-author documentation while ensuring alignment with stakeholders?

To co-author documentation with stakeholder alignment, start with a Context Gathering stage to capture requirements, then use a Refinement & Structure stage to iterate content collaboratively before finalizing the draft.

Can I use a structured workflow for writing decision logs and design docs?

Yes, a structured co-authoring workflow supports writing decision logs, design docs, proposals, and technical specs. It guides the content through context capture, structural refinement, and readability validation.

How does reader testing work when creating proposals?

Reader testing for proposals works as the third stage of a co-authoring workflow. It validates document readability and clarity by testing the finalized content with actual readers, ensuring the proposal communicates its intended message effectively.

What are the stages of collaborative documentation co-authoring?

The stages of collaborative documentation co-authoring are Context Gathering to capture initial information, Refinement & Structure to iterate and organize content, and Reader Testing to validate clarity with target audiences.