skills.rest
H2OSLabs
H2OSLabsOFFICIAL
Explore all skills by this author →
GitHub

doc-coauthoring

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

1|1|Updated Jan 27, 2026
Search Tags:#workflow#documentation#writing#proposals#specs#co-authoring
One-click install
npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill doc-coauthoring-h2oslabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/H2OSLabs/SynnovatorZero/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/H2OSLabs/SynnovatorZero --skill doc-coauthoring-h2oslabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, collaborative workflow to create documentation, proposals, technical specs, and decision records, reducing ambiguity and improving reader readiness.

Core Features & Use Cases

  • Context Gathering: Collects relevant background and constraints via guided questions to close knowledge gaps.
  • Refinement & Structure: Iteratively builds sections, brainstorms options, and applies surgical edits to improve clarity and persuasiveness.
  • Reader Testing: Validates the document with a fresh perspective to surface gaps and ensure readability.
  • Use Case: Ideal for drafting a design doc for a new feature, a PRD, or a decision log, ensuring a structured, reader-friendly outcome.

Quick Start

To begin, state that you want to co-author a document (e.g., “draft a design spec for feature X”). The workflow will start with Context Gathering, proceed through Refinement & Structure, and end with Reader Testing. Provide any context, templates, or a draft you already have, and let the skill guide the process step by step.

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 proposals to ensure they are reader-ready?▼

To co-author technical specs and proposals, use a structured three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. This process manages sections and iterative edits to ensure reader readiness.

What is the best way to structure a collaborative writing workflow for a PRD?▼

The best way to structure a PRD collaborative writing workflow is through iterative section building and surgical edits. This refinement stage improves clarity and persuasiveness by brainstorming options and managing sections systematically.

How do I validate a decision record with a fresh perspective before finalizing it?▼

To validate a decision record with a fresh perspective, apply a Reader Testing stage. This mechanism surfaces gaps and ensures readability by checking the document against audience alignment criteria before finalizing.

Do I need external tooling to draft a design doc using a guided assistant framework?▼

No, you do not need external tooling to draft a design doc. The co-authoring workflow operates entirely within the guided assistant framework to manage stages, sections, and iterative edits without external dependencies.

How do I gather context and constraints when drafting a technical specification?▼

To gather context and constraints when drafting a technical specification, use guided questions during the Context Gathering stage. This closes knowledge gaps by collecting relevant background before proceeding to structure refinement.

Related Skills

Explore More Content & Communication Skills→
ProjectEuropaProjectEuropa
4

doc-coauthoring

Orchestrate staged AI-assisted documentation workflows from context gathering to reader testing.

Community
Advanced
nirukk52nirukk52

doc-coauthoring

Guide structured co-authoring of technical specifications through iterative drafting and reader testing.

Community
Advanced
hitsumabushi334hitsumabushi334

brainstorming

Guide structured ideation through one-question-at-a-time dialogue.

Community
Basic
jordi-murgojordi-murgo

prd-doc-writer

Guide story-driven PRD creation with ASCII wireframes and Mermaid diagrams.

Community
Advanced