doc-coauthoring

Guide collaborative documentation creation with structured questioning and reader-style validation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you produce collaborative documentation or technical specs that are complete, well-structured, and easy for new readers to understand.

Core Features & Use Cases

  • Context Gathering: Guides you to surface the missing background, constraints, and audience assumptions before writing.
  • Refinement & Structure: Builds the document section-by-section with questions, option brainstorming, curation, and iterative edits.
  • Reader Testing: Validates the finished doc using a fresh “reader” perspective to catch ambiguities and hidden assumptions.
  • Use case: Turn a rough idea for a PRD, RFC, decision doc, or design spec into a shareable document that others can paste into Claude and still follow.

Quick Start

Tell the skill what type of document you are writing, who the audience is, and what format (if any) you want to follow.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I draft technical specs and documentation that are easy for new readers to follow?

Draft technical specs by gathering missing context first, refining structure section-by-section, and validating readability with a blind-reader test. This staged editorial workflow surfaces trade-offs and audience assumptions to reduce ambiguity in PRDs and design docs.

What is the best way to structure an RFC-style proposal or decision record collaboratively?

Structure RFC-style proposals by guiding section-by-section drafting with iterative edits and option brainstorming. Curation builds the document incrementally while making constraints and trade-offs explicit for the audience.

Can I use this workflow to validate a PRD before sharing it with stakeholders?

Yes, validate a PRD using the final blind-reader validation loop. A fresh reader perspective catches hidden assumptions and ambiguities, ensuring the document reads clearly and lands well before stakeholder distribution.

How do I surface missing constraints and audience assumptions when writing design docs?

Surface missing constraints in design docs through structured questioning before writing. Context gathering prompts you to articulate background, trade-offs, and audience assumptions explicitly, reducing omission risks later.

Does this collaborative documentation process work for complex technical writing like specs and proposals?

Yes, this collaborative documentation process works for technical writing including specs, proposals, and decision records. It applies a staged workflow of context gathering, iterative drafting, and reader testing to handle complex trade-offs.

What are the limitations of iterative section-by-section drafting for editorial workflows?

Iterative section-by-section drafting requires upfront context gathering and a final reader-testing loop, meaning it demands more stages than direct writing. Skipping the validation loop risks leaving hidden assumptions uncaught in the document.