doc-coauthoring

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

73|11|Updated May 18, 2025
One-click install
npx skills add https://github.com/datascienceworld-kan/vinagent --skill doc-coauthoring-datascienceworld-kan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/datascienceworld-kan/vinagent/tree/main/agentskills/skills/skills/doc-coauthoring
Command: npx skills add https://github.com/datascienceworld-kan/vinagent --skill doc-coauthoring-datascienceworld-kan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured workflow for guiding users through collaborative document creation. Act as an active guide, walking users through three stages: Context Gathering, Refinement & Structure, and Reader Testing.

Core Features & Use Cases

  • A three-stage workflow (Context Gathering, Refinement & Structure, Reader Testing) to guide documentation tasks.
  • Trigger-based activation when users mention writing docs, proposals, specs, or decision docs.
  • Stage-by-stage drafting with clarifying questions, brainstorming options, and iterative refinement.
  • Reader testing by validating the document with a fresh perspective to catch blind spots.

Quick Start

Offer the structured doc co-authoring workflow and begin Stage 1: Context Gathering.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is structured document co-authoring and when do I need it?

Structured document co-authoring is a guided workflow using context gathering, refinement, and reader testing to ensure clarity and completeness. You need it when writing proposals, specs, or decision docs to enforce consistency and catch blind spots iteratively.

How do I start writing a technical specification using a stage-based workflow?

To start writing a technical specification using a stage-based workflow, begin with Stage 1 Context Gathering by answering clarifying questions. This establishes the foundational requirements before moving to iterative refinement and drafting.

Can I use this workflow for collaborative proposals and decision docs?

Yes, you can use this workflow for collaborative proposals and decision docs. It triggers automatically for these document types, offering templates and iterative drafting to maintain reader-centricity and completeness throughout the co-authoring process.

What is the best way to refine document structure during collaborative drafting?

The best way to refine document structure during collaborative drafting is through Stage 2 Refinement. It enforces guided workflows with guardrails and templates, allowing you to brainstorm options and iteratively draft sections for maximum clarity.

How does reader testing validate documentation for blind spots?

Reader testing validates documentation for blind spots by applying a fresh perspective during Stage 3. It reviews the drafted document to ensure reader-centricity, verifying that the structure and context communicate the intended message clearly and completely.