doc-coauthoring

Guide teams through a three-stage co-authoring workflow for structured documentation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides teams through a structured workflow for collaborative documentation, reducing context loss, redundant edits, and misalignment across drafts.

Core Features & Use Cases

  • Stage-based workflow: Context Gathering, Refinement & Structure, and Reader Testing.
  • Iterative drafting with clarifying questions, brainstorming options, and surgical edits.
  • Use cases include PRDs, design docs, technical specs, proposals, and decision records to improve clarity and publish-ready documentation.

Quick Start

Start by offering the three-stage workflow to the user and, if accepted, begin Stage 1: Context Gathering by requesting the document type, primary audience, desired impact, templates, and constraints. The user can provide an initial context dump, and you will generate clarifying questions and proceed to Stage 2.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I structure collaborative documentation like PRDs and technical specs?

Structured collaborative documentation requires a staged co-authoring workflow: gathering context, refining structure, and reader testing. This approach enforces iterative drafting with clarifying questions and surgical edits to ensure clarity across PRDs, design docs, and technical specs.

What is the best way to co-author design docs to reduce context loss?

Co-authoring design docs effectively requires a structured workflow that cycles through context gathering, refinement, and reader testing. This process uses guided questions and brainstorming options to align teams, preventing redundant edits and misalignment across drafts.

How do I start a co-authoring workflow for a proposal?

Start co-authoring a proposal by initiating context gathering, where you define the document type, primary audience, desired impact, and constraints. You provide an initial context dump, then receive clarifying questions before moving to refinement and reader testing stages.

Can I use this co-authoring workflow for decision records?

Yes, this co-authoring workflow supports decision records alongside proposals, PRDs, and technical specs. It applies a three-stage process of context gathering, structural refinement, and reader testing to iteratively refine content and ensure publish-ready documentation.

How does reader testing work for technical documentation?

Reader testing for technical documentation is the final stage of the co-authoring workflow. It evaluates reader comprehension by applying surgical edits to the refined draft, ensuring the final document achieves its desired impact and is clearly understood by the primary audience.