doc-coauthoring

Guide structured co-authoring workflows for technical documentation from context gathering to reader testing.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/daxiangnaoyang/lobster-bot --skill doc-coauthoring-daxiangnaoyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/daxiangnaoyang/lobster-bot/tree/main/skills/skills/doc-coauthoring
Command: npx skills add https://github.com/daxiangnaoyang/lobster-bot --skill doc-coauthoring-daxiangnaoyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a collaborative document creation workflow, reducing context drift and helping teams produce clear, reader-friendly documentation. It walks users through three stages: Context Gathering, Refinement & Structure, and Reader Testing, ensuring accurate transfer of context and iterative improvement.

Core Features & Use Cases

  • Context Gathering: collect relevant background, constraints, audience, and goals, with clarifying questions to fill gaps.
  • Refinement & Structure: brainstorm, draft, and iteratively refine each section to improve clarity and coherence.
  • Reader Testing: validate the doc with a fresh reader (or Claude instance) to surface ambiguities and ensure readability.
  • Triggering and applicability: ideal for writing documentation, proposals, technical specs, decision docs, RFCs, and other structured content.

Quick Start

Initiate Stage 1 by offering the three-stage co-authoring workflow and guiding the user through Context Gathering.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is a structured co-authoring workflow for technical documentation?

A structured co-authoring workflow guides teams through context gathering, refinement, and reader testing to produce clear technical specs and proposals. It reduces context drift by applying staged prompts and validation checks for iterative improvement.

How do I write an RFC with Claude using a structured workflow?

To write an RFC, initiate the co-authoring workflow to gather context, refine structure through iterative drafting, and validate readability via reader testing. This staged process ensures your RFC accurately transfers context and remains reader-friendly.

Can I use this co-authoring workflow for design docs and proposals?

Yes, the co-authoring workflow suits design docs, proposals, technical specs, decision docs, and RFCs. It applies structured context gathering and refinement stages to ensure formal documents are accurate, coherent, and readable for the target audience.

How do I validate documentation readability before publishing?

Validate documentation readability by running the reader testing stage, which uses a fresh reader or Claude instance to surface ambiguities. This validation check ensures your final document is clear and accurately conveys its context to the audience.

What is the best way to prevent context drift when drafting technical specs?

The best way to prevent context drift is using a structured co-authoring workflow that gathers background and constraints upfront. Iterative refinement and validation checks keep technical specs aligned with initial goals and audience needs.

When do I need a structured workflow for collaborative document creation?

You need a structured workflow for collaborative document creation when writing formal content like technical specs, RFCs, or proposals. It ensures accurate context transfer and readability through guided context gathering, refinement, and reader testing stages.