doc-coauthoring

Guide structured co-authoring of proposals, technical specs, and decision records.

24|8|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/vadimcomanescu/codex-skills --skill doc-coauthoring-vadimcomanescu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/vadimcomanescu/codex-skills/tree/main/skills/.experimental/product/doc-coauthoring
Command: npx skills add https://github.com/vadimcomanescu/codex-skills --skill doc-coauthoring-vadimcomanescu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many teams struggle to transfer context, iterate effectively, and validate that a document actually works for readers; this Skill guides users through a structured co-authoring workflow to reduce misunderstandings, missing context, and revision cycles.

Core Features & Use Cases

  • Structured three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing to move from raw context to a reader-ready document.
  • Iterative section-by-section drafting: Ask clarifying questions, brainstorm options, curate content, and apply surgical edits with artifact creation or file edits.
  • Reader validation: Simulate a fresh reader (or sub-agent) to surface ambiguities and iterate on problematic sections before sharing externally.
  • Use case: Draft a technical spec or decision doc with the team by dumping project context, refining each section together, and validating clarity for non-authors.

Quick Start

Start a co-authoring session by telling me the document type, the primary audience, and pasting any existing context or links.

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 with my team?

Co-authoring technical specs and decision docs is guided through a structured three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. You provide raw project context, and the workflow iterates section-by-section to produce a reader-ready document.

What is the best way to validate that a technical document is clear for non-authors?

To validate document clarity for non-authors, you can use a reader testing stage that simulates a fresh reader. This process surfaces ambiguities and allows you to iterate on problematic sections before sharing the document externally.

How do I start a collaborative drafting session for a proposal?

Start a collaborative drafting session by specifying the document type, identifying the primary audience, and pasting any existing context or links. The workflow then collects this context and asks clarifying questions to refine the structure.

Can I pull shared documents into the co-authoring workflow using connectors?

Yes, the co-authoring workflow supports optional connector access to pull shared documents. This allows you to import existing context directly into the session for refinement and section-by-section editing.

Does collaborative documentation editing support surgical text replacements?

Yes, collaborative documentation editing supports iterative str_replace-style edits. This allows you to apply surgical modifications to specific sections of the draft without rewriting the entire document.

When do I need a structured workflow for drafting documentation?

You need a structured workflow for drafting documentation when your team struggles to transfer context, iterate effectively, and validate readability. It reduces misunderstandings, missing context, and revision cycles during document handoffs.