doc-coauthoring

Guide structured documentation through context gathering, section refinement, and reader Q&A testing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of producing structured, reader-friendly documentation by guiding you to gather context, refine content section-by-section, and validate clarity before others read it.

Core Features & Use Cases

  • Context Gathering: Collect meta-information (audience, purpose, constraints, template/format) and capture the full knowledge gap through a structured context dump.
  • Refinement & Structure: Build the document iteratively by drafting each section from options, then curation, gap checks, and surgical refinement based on feedback.
  • Reader Testing: Validate the finished doc by predicting realistic reader questions and testing with a fresh Claude (or asking the user to do manual testing) to catch ambiguity and hidden assumptions.

Quick Start

Tell me what kind of document you’re writing (e.g., PRD/RFC/design/decision doc), who the audience is, and any constraints or template you want to follow, and I’ll guide you through the co-authoring workflow step by step.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is the best way to write a technical spec from partial knowledge or messy inputs?

Writing a PRD or decision doc from partial knowledge requires a three-stage workflow: gathering missing context through targeted questions, drafting section scaffolds, and iteratively refining content via surgical edits and reader Q&A testing.

How do I validate my RFC for hidden assumptions before sharing it?

To validate an RFC for hidden assumptions, perform reader-focused testing by predicting realistic reader questions and testing the document with a fresh instance to detect ambiguity and uncover implicit assumptions.

Can I use this workflow to produce structured proposals if I only have a rough outline?

Yes, you can produce structured proposals from a rough outline because the workflow starts with a context dump to capture knowledge gaps, then builds the document iteratively by drafting and refining each section.

What do I need to start collaborative writing for technical documentation?

To start collaborative writing for technical documentation, you need to provide the document type, the target audience, the purpose, and any constraints or templates you want the workflow to follow.

How does iterative refinement work when drafting structured docs?

Iterative refinement for structured docs works by drafting each section from options, performing gap checks, and applying surgical edits based on feedback to ensure the document is reader-ready.