doc-coauthoring

Guide structured documentation drafting through context gathering, section-by-section curation, and reader testing.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/leexb-wp21-prog/Azure-Ticket-Helpdesk --skill doc-coauthoring-leexb-wp21-prog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/leexb-wp21-prog/Azure-Ticket-Helpdesk/tree/main/.cursor/skills/skills-main/skills-main/skills/doc-coauthoring
Command: npx skills add https://github.com/leexb-wp21-prog/Azure-Ticket-Helpdesk --skill doc-coauthoring-leexb-wp21-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents documentation from becoming confusing, incomplete, or unusable for readers by guiding you through structured context gathering, iterative refinement, and reader-focused testing.

Core Features & Use Cases

  • Context Gathering with Clarifying Questions: Captures the right meta-context (audience, impact, constraints, templates) and lets you dump existing background so the doc build-up is grounded.
  • Refinement & Section-by-Section Drafting: Builds each section with targeted questions, brainstormed options, curation (keep/remove/combine), drafting, and iterative edits.
  • Reader Testing to Detect Blind Spots: Runs a fresh “reader” pass (or guides you to do it) to catch ambiguity, missing assumptions, and inconsistencies before others read the result.

Use Case Example: When you’re drafting an RFC or design/decision document, this workflow helps you transfer context into a coherent proposal, then validates that a reader can follow it without your internal background.

Quick Start

Use the doc-coauthoring workflow to draft your documentation in three stages by sharing the document type, audience, constraints, and any existing notes or templates.

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 decision docs without missing critical context?

Co-authoring technical specs requires gathering audience, impact, and constraints upfront. A structured workflow captures this meta-context through clarifying questions, then builds each section iteratively with brainstorming, curation, and drafting to ensure completeness.

What's the best way to draft an RFC that readers can follow without my internal background?

Drafting an RFC that readers understand requires a reader-testing pass to detect ambiguity and missing assumptions. After section-by-section drafting, a fresh review validates that the proposal is coherent without relying on the author's internal context.

How does iterative refinement work for structured documentation like PRDs and proposals?

Iterative refinement for PRDs and proposals works through a three-stage process: context gathering, section-by-section drafting with targeted questions and curation, and reader testing. Each section is built with brainstormed options that are kept, removed, or combined before final edits.

Do I need a specific template format to start a structured writing workflow for technical documentation?

No specific template format is required to start structured technical documentation. The workflow accepts any existing notes or templates you provide during context gathering, using them to ground the drafting process alongside audience and constraint inputs.

Can I use co-authoring workflows for proposal writing and not just technical specifications?

Yes, co-authoring workflows apply to proposal writing, decision docs, PRDs, and any structured writing task. Any document that benefits from iterative refinement and reader-focused validation can use this three-stage context-to-drafting-to-testing process.

Why does my documentation have blind spots that readers catch but I miss during drafting?

Documentation blind spots occur when authors assume internal context that readers lack. A dedicated reader-testing pass catches ambiguity, missing assumptions, and inconsistencies by reviewing the finished draft from a fresh perspective before others read it.