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.