doc-coauthoring

Guide staged document co-authoring with context gathering, drafting, and reader testing.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/adamatdevops/forge-works --skill doc-coauthoring-adamatdevops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/adamatdevops/forge-works/tree/main/.skills/anthropics/doc-coauthoring
Command: npx skills add https://github.com/adamatdevops/forge-works --skill doc-coauthoring-adamatdevops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of writing documents that make sense to the author but fail for real readers, by guiding you through structured collaboration and validation.

Core Features & Use Cases

  • Stage-based co-authoring workflow that moves from context gathering to iterative refinement and then reader testing.
  • Section-by-section drafting with structured iteration (clarify what to include, brainstorm options, curate, draft, and refine via targeted edits).
  • Reader Testing pass using a fresh Claude instance (or manual instructions) to catch ambiguity, missing context, and contradictions before others read it.

Quick Start

Tell the doc-coauthoring skill what type of document you’re writing, who the audience is, and what outcome you want, and ask it to start Stage 1 (Context Gathering).

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 collaboratively to ensure readers understand the context?

Collaborative technical spec creation uses a stage-based co-authoring workflow that gathers context, iteratively drafts sections with structured edits, and runs reader testing to verify comprehension before finalizing.

What is the best way to draft architecture and decision documents without missing critical context?

Drafting architecture and decision documents is best handled through a structured workflow that brainstorms options, curates content, drafts section by section, and tests outputs with a fresh model run to catch missing critical context.

How do I test if my proposal or technical writing will confuse readers before publishing?

Reader testing for proposals and technical writing is done using a fresh model instance or manual test instructions to identify ambiguity, missing context, and contradictions that would otherwise confuse actual readers.

Can I use this collaboration workflow for iterative document drafting with section-by-section refinement?

Yes, iterative document drafting supports section-by-section refinement by clarifying what to include, brainstorming options, curating, drafting, and applying targeted edits throughout the collaboration workflow.

What do I need to start the document co-authoring workflow for structured writing tasks?

To start document co-authoring, you need to define the document type, target audience, and desired outcome, which triggers Stage 1 context gathering to collect clarifying inputs for the structured writing task.

When should I avoid using a stage-based co-authoring workflow for document creation?

You should avoid stage-based co-authoring workflows for simple documents that require no reader testing or context gathering, as the structured iteration and comprehension verification add unnecessary overhead to the drafting process.