doc-coauthoring

Guide structured co-authorship of documentation through a three-stage workflow.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/XinyuYao98/engineering-playbook --skill doc-coauthoring-xinyuyao98
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/XinyuYao98/engineering-playbook/tree/main/skill/doc-coauthoring
Command: npx skills add https://github.com/XinyuYao98/engineering-playbook --skill doc-coauthoring-xinyuyao98

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through a deterministic, three-stage workflow to co-author documentation, proposals, technical specs, and related structured content, improving clarity and collaboration.

Core Features & Use Cases

  • Structured, three-stage workflow (Context Gathering, Refinement & Structure, Reader Testing) guiding users from initial context to readers' validation.
  • Interactive prompting and drafting scaffold that captures context, iterates sections, and tests readability with a fresh audience.
  • Use Case: a team needs to draft a technical spec with multiple stakeholders; this Skill coordinates context gathering, section-by-section drafting, and reader validation to produce a ready-to-review doc.

Quick Start

Initiate Stage 1 by gathering context and questions, then proceed through refinement and reader testing to produce a complete 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 with multiple stakeholders?

Co-authoring technical specs is facilitated through a structured three-stage workflow that gathers context, refines section structure, and tests readability with readers to align stakeholders and accelerate output.

What is the best way to structure collaborative proposal writing?

Structured proposal writing applies an iterative refinement workflow using interactive prompts and drafting scaffolds to capture context, draft sections, and validate readability with a fresh audience.

How do I gather context before drafting decision docs?

Context gathering for decision docs initiates the first stage of the workflow by providing interactive questions and prompts to capture necessary stakeholder inputs before section drafting begins.

Can I use this workflow for iterative documentation review?

Iterative documentation review is supported during the refinement and structure stage, allowing section-by-section drafting and refinement before proceeding to reader testing with a fresh audience.

When do I need a structured co-authoring workflow for documentation?

A structured co-authoring workflow is needed when a team must draft proposals or technical specs with multiple stakeholders, requiring coordinated context gathering, iterative drafting, and reader validation.