doc-coauthoring

Guide structured co-authoring from rough ideas to reader-ready documentation.

Updated May 15, 2026
One-click install
npx skills add https://github.com/lth0/codexSkill --skill doc-coauthoring-lth0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/lth0/codexSkill/tree/main/skills/agents/doc-coauthoring
Command: npx skills add https://github.com/lth0/codexSkill --skill doc-coauthoring-lth0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents documentation from being written in a way that only works for the author, by guiding co-authors through structured context gathering, iterative drafting, and a reader-focused validation pass.

Core Features & Use Cases

  • Context Gathering with Clarifying Questions: Collects the document type, audience, goals, templates, and constraints before drafting.
  • Refinement & Section-by-Section Building: Brainstorms options per section, lets the user curate what to keep, then drafts and refines with iterative edits.
  • Reader Testing for Blind Spots: Validates clarity by testing the drafted doc with a fresh “reader” perspective and fixing ambiguity or missing assumptions.

Use cases: PRDs, design docs, RFCs, decision docs, technical specs, proposals, and other structured writing where correctness and readability for others matter.

Quick Start

Use this workflow when you’re starting a doc and ask for a “co-authoring workflow” to draft a reader-ready proposal using stages for context gathering, structured refinement, and reader testing.

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

To co-author technical specs effectively, you need a structured workflow that gathers context through clarifying questions, drafts sections iteratively, and validates results with reader testing to catch ambiguity.

What is the best way to draft a PRD without missing key context?

Drafting a PRD without missing context requires starting with context gathering, where you define the audience, goals, and constraints before building the document section-by-section with iterative refinement.

How do I validate my decision docs for blind spots before sharing?

Validating decision docs for blind spots involves performing a reader testing pass, which tests the drafted document against a fresh perspective to identify and fix missing assumptions or ambiguity.

Can I use this co-authoring workflow for writing proposals and RFCs?

Yes, you can use this co-authoring workflow for writing proposals and RFCs, as it applies to any structured writing task like technical specs, PRDs, and decision docs where correctness and readability matter.

How does iterative section refinement work for proposal writing?

Iterative section refinement for proposal writing works by brainstorming options for each section, allowing you to curate what to keep, and then drafting and refining the content through successive edits until the section is polished.

Why does my technical documentation only make sense to the author?

Technical documentation often only makes sense to the author because it lacks a structured reader-focused validation pass to identify missing context, ambiguity, and assumptions that a fresh reader would need clarified.