doc-coauthoring

Guide users through structured co-authoring with context gathering, refinement, and reader testing.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/jieni777/opencode-config-backup --skill doc-coauthoring-jieni777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/jieni777/opencode-config-backup/tree/main/skills/doc-coauthoring
Command: npx skills add https://github.com/jieni777/opencode-config-backup --skill doc-coauthoring-jieni777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guide users through a structured, collaborative workflow to co-author documentation, proposals, technical specs, and decision docs, ensuring context is captured, content is iterated efficiently, and readers are effectively served.

Core Features & Use Cases

  • Context Gathering: Ask clarifying questions to surface essential details and align collaborators.
  • Refinement & Structure: Iteratively build sections through brainstorming, editing, and structural checks.
  • Reader Testing: Validate the doc with a fresh perspective to catch gaps and misinterpretations. Typical use cases include drafting PRDs, design docs, decision records, or technical specs within cross-functional teams.

Quick Start

Offer the structured co-authoring workflow to begin Stage 1: Context Gathering and guide the user through subsequent stages.

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 and proposals with a structured workflow?

Co-authoring technical specs and proposals requires a structured workflow that guides collaborators through context gathering, iterative refinement, and reader testing to ensure all essential details are captured and validated. This approach aligns cross-functional teams by surfacing clarifying questions before drafting begins.

What is the best way to gather context when drafting cross-functional documentation?

The best way to gather context for cross-functional documentation is to ask clarifying questions that surface essential details and align collaborators. This stage-based guidance ensures all team members share the same foundational understanding before the actual writing begins.

How do I validate a decision document with readers before finalizing it?

You validate a decision document by applying reader testing, which involves reviewing the drafted content from a fresh perspective. This catches gaps and misinterpretations early, ensuring the final document effectively serves its intended audience before publication.

Can I use this structured coauthoring workflow for writing PRDs and design docs?

Yes, you can use this structured coauthoring workflow for writing PRDs and design docs. It supports creating technical specs, decision records, and similar structured content by enabling iterative refinement and structural checks across cross-functional teams.

How do I iteratively refine and structure a technical spec during collaborative drafting?

To iteratively refine and structure a technical spec, you build sections through brainstorming, editing, and structural checks. This refinement stage ensures the document logically flows and comprehensively covers the topic while incorporating feedback from all collaborators.