# Doc Coauthoring

A structured workflow for co-authoring high-signal docs (PRD, RFC, design docs...

- Repository: https://github.com/shareAI-lab/Kode-CLI (5235 stars)
- Category: Design
- License: Complete terms in LICENSE.txt
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add shareAI-lab/Kode-CLI --skill doc-coauthoring -g -a claude-code -y`
Codex: `npx skills add shareAI-lab/Kode-CLI --skill doc-coauthoring -g -a codex -y`
Cursor: `npx skills add shareAI-lab/Kode-CLI --skill doc-coauthoring -g -a cursor -y`
Gemini CLI: `npx skills add shareAI-lab/Kode-CLI --skill doc-coauthoring -g -a gemini-cli -y`

## Description

A structured workflow for co-authoring high-signal docs (PRD, RFC, design docs, proposals, decision records). Use when the user needs to turn messy context into a readable artifact with clear goals, tradeoffs, and next steps. Emphasizes context capture, outline-first drafting, and context-free reader testing to catch blind spots.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Doc Co-Authoring

Turn partial context into a clear document by following a staged workflow. Keep the user in control of decisions, and optimize for a doc that works for readers who do **not** share the author’s context.

## Triggers

Use this workflow when the user asks to:

- write or refine documentation, proposals, RFCs, PRDs, decision docs, specs
- “summarize our discussion into a doc”
- “make this readable for others” / “share with the team”
- create a template or standard for recurring documents

If the user explicitly wants freeform writing, keep the workflow lightweight (ask fewer questions; draft faster).

---

## The Workflow (3 stages)

### Stage 1, Context Capture (close the gap)

Goal: collect the minimum context required to write a doc that is correct, scoped, and actionable.

Ask for:

1. **Doc type + goal**: what is this document for, and what decision/action should it unlock?
2. **Audience**: who will read it, and what do they already know?
3. **Constraints**: deadlines, non-goals, dependencies, security/compliance, platform limits.
4. **Current state**: what exists today? what’s broken? what’s missing?
5. **Options considered**: at least 1, 2 alternatives and why they may/ may not work.
6. **Success criteria**: how we know it worked (metrics, user outcomes, acceptance tests).
7. **Open questions**: unknowns that block writing certain sections.

Output of Stage 1:

- a short “context snapshot”
- a list of open questions (ranked by importance)
- a proposed doc outline (1 screen)

### Stage 2, Outline-First Drafting (iterate by section)

Goal: draft a document in layers without losing coherence.

Rules:

- **Outline before prose**. Do not write full paragraphs until the outline is agreed.
- **One section at a time**. Draft → review → revise, then move on.
- **Maintain a decision log** (small bullet list) so changes are explicit.
- **Keep unknowns visible**: unresolved items stay in an “Open Questions / Risks” section, not hidden.

The rest: https://github.com/shareAI-lab/Kode-CLI/blob/HEAD/packages/builtin-skills/skills/doc-coauthoring/SKILL.md