doc-coauthoring

Guide users through a three-stage documentation co-authoring workflow.

1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/Kang-chen/Agent-skills --skill doc-coauthoring-kang-chen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/Kang-chen/Agent-skills/tree/main/doc-coauthoring
Command: npx skills add https://github.com/Kang-chen/Agent-skills --skill doc-coauthoring-kang-chen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through a structured, three-stage workflow to create high-quality documentation. It helps teams gather context, iteratively refine structure, and validate readability before finalizing a document.

Core Features & Use Cases

  • Three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing guide the entire drafting process.
  • Trigger-based offers: Proactively offers a guided workflow when users mention writing documentation, proposals, specs, or decision docs.
  • Artifact-backed drafting: Creates scaffolds and sections, enabling iterative drafting with optional artifact creation for collaboration.

Quick Start

Initiate the workflow when a user requests documentation (e.g., technical spec, proposal, design doc). Follow the three stages: Context Gathering, Refinement & Structure, and Reader Testing. If the user declines, switch to freeform drafting; if accepted, create an initial artifact scaffold and progressively draft sections.

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 to ensure reader readiness?

Co-author technical specs using a structured three-stage workflow covering context gathering, iterative refinement, and reader testing to produce reader-ready documents. This process ensures proposals and design docs are validated before finalizing.

What is the best way to structure a document workflow for stakeholder alignment?

The best way to achieve stakeholder alignment is a guided document workflow that creates artifact scaffolds with placeholders, enabling iterative drafting and progressive section completion for continuous feedback.

Can I draft decision records and proposals without a strictly guided workflow?

Yes, you can draft decision records in freeform mode if you decline the structured workflow. However, the guided approach is recommended to ensure proper context gathering and readability testing.

How does iterative drafting work for substantial documentation tasks?

Iterative drafting works by generating an initial artifact scaffold and progressively filling in document sections. This allows teams to refine structure and integrate stakeholder feedback continuously throughout the writing process.

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

You need a structured co-authoring workflow when creating substantial documentation like technical specs, proposals, or design docs that require extensive context gathering, stakeholder alignment, and reader testing before finalization.

Does this co-authoring workflow support fetching external templates and sources?

Yes, the co-authoring workflow supports optional integrations to fetch templates or source materials during the initial context gathering stage to help scaffold the document effectively.