doc-coauthoring

Guide structured co-authoring workflows for technical documents with iterative refinement.

Updated Jan 26, 2023
One-click install
npx skills add https://github.com/yuyalun-allen/dotfiles --skill doc-coauthoring-yuyalun-allen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/yuyalun-allen/dotfiles/tree/main/tools/pi/agent/skills/doc-coauthoring
Command: npx skills add https://github.com/yuyalun-allen/dotfiles --skill doc-coauthoring-yuyalun-allen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many collaborative documents fail because authors assume shared context, skip structured iteration, and never test whether readers can actually use the doc; this Skill closes that gap by guiding authors through context gathering, iterative drafting, and reader-focused testing so documents work when others read them.

Core Features & Use Cases

  • Context Gathering: Elicit background, constraints, stakeholders, and artifacts so the draft starts with complete context.
  • Refinement & Structure: Brainstorm section content, curate options, draft section-by-section, and perform surgical edits with artifact management.
  • Reader Testing: Simulate fresh-reader queries or run sub-agent tests to reveal ambiguities and fix gaps before sharing.
  • Use Case: Draft a technical spec or decision doc by dumping project context, iteratively building the core proposal section, and validating clarity with reader-focused tests.

Quick Start

Tell me the document type, paste any context or links, and say "start coauthoring" to begin the three-stage workflow.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I structure a technical specification through collaborative editing?

To structure a technical specification through collaborative editing, this workflow elicits project context, drafts sections iteratively, and simulates reader questions to validate clarity before sharing.

What is the best way to co-author a proposal document with section-level refinement?

The best way to co-author a proposal is brainstorming section content interactively, curating options, drafting section-by-section, and performing surgical edits to ensure comprehensive context and structured iteration.

How does reader testing work for validating a drafted PRD?

Reader testing for a drafted PRD simulates fresh-reader queries or runs sub-agent tests to reveal ambiguities and surface gaps, ensuring the document works when others read it before final sharing.

Can I draft a decision document by pasting raw project context and links?

Yes, you can draft a decision document by pasting raw project context and links; the workflow gathers background, constraints, and stakeholders to iteratively build the core proposal section.

Why do collaborative documents fail and how can I fix gaps before sharing?

Collaborative documents fail when authors assume shared context and skip structured iteration; fix gaps by gathering complete context, refining drafts interactively, and simulating reader questions to test usability.

Does this co-authoring workflow support drafting PRDs and technical specifications?

Yes, this co-authoring workflow supports drafting PRDs, technical specifications, decision documents, and proposals by applying a structured three-stage process of context gathering, drafting, and reader-focused validation.