doc-coauthoring

Guide authors through structured document creation with staged context gathering and reader testing.

2|1|Updated Jul 25, 2026
One-click install
npx skills add https://github.com/CODE-SAURABH/OpenSkills --skill doc-coauthoring-code-saurabh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/CODE-SAURABH/OpenSkills/tree/main/doc-coauthoring
Command: npx skills add https://github.com/CODE-SAURABH/OpenSkills --skill doc-coauthoring-code-saurabh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents substantial documents from becoming unclear, incomplete, or overly author-centric by guiding the author through structured context gathering, collaborative drafting, refinement, and reader testing.

Core Features & Use Cases

  • Context Gathering: Clarify the document type, audience, desired outcome, constraints, and relevant background before writing.
  • Section-by-Section Refinement: Develop each section through targeted questions, brainstorming, curation, drafting, gap checks, and focused revisions.
  • Reader Testing: Predict reader questions, identify ambiguity and assumed knowledge, and resolve gaps before finalizing the document.
  • Use Cases: Create PRDs, design documents, RFCs, decision documents, one-pagers, technical specifications, proposals, and other substantial structured documents.

Quick Start

Ask the doc-coauthoring skill to help draft a PRD by gathering context first, refining each section collaboratively, and testing the finished document with a fresh reader.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I write a structured PRD or design doc that addresses reader questions?▼

To write a structured PRD or design doc, you need a process that gathers context, refines sections collaboratively, and performs reader testing to predict questions and resolve gaps before finalizing. This ensures the document is clear and reader-ready.

What is the best way to draft an RFC without missing key technical constraints?▼

The best way to draft an RFC is through staged context gathering to clarify constraints, followed by section-by-section refinement with gap checks and alternative analysis. This prevents the document from becoming incomplete or overly author-centric.

Can I use this structured writing process for technical specifications and one-pagers?▼

Yes, you can use this structured writing process for technical specifications, one-pagers, proposals, and decision docs. It applies to any substantial writing workflow requiring targeted questions, brainstorming, and focused revisions.

How does reader testing work when authoring technical documents?▼

Reader testing during technical document authoring involves predicting reader questions, identifying ambiguity and assumed knowledge, and resolving those gaps. This step ensures the finished document achieves reader-ready clarity before completion.

Why do my technical proposals end up overly author-centric and unclear?▼

Technical proposals often become overly author-centric and unclear when they skip structured context gathering and section-by-section curation. Without targeted refinement and alternative analysis, authors fail to address actual reader needs and assumed knowledge.