doc-coauthoring

Guides collaborative document drafting through context gathering, iterative refinement, and reader testing.

2|Updated May 30, 2026
One-click install
npx skills add https://github.com/virahitvin8/crafty-gis --skill doc-coauthoring-virahitvin8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/virahitvin8/crafty-gis/tree/main/GIT_STAR/assignment-generator/antigravity-skills-main/antigravity-skills-main/skills/doc-coauthoring
Command: npx skills add https://github.com/virahitvin8/crafty-gis --skill doc-coauthoring-virahitvin8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing documentation, proposals, and technical specs alone often produces documents full of blind spots, missing context, and unclear sections that confuse readers. This Skill structures the co-authoring process so the final document actually works for its intended audience. ## Core Features & Use Cases - Three-Stage Workflow: Guides users through Context Gathering, Refinement & Structure, and Reader Testing for any structured document. - Section-by-Section Drafting: Brainstorms 5-20 options per section, curates content with the user, and iteratively refines drafts using targeted edits. - Reader Testing: Validates the finished document with a fresh, context-free reviewer to catch ambiguity, false assumptions, and contradictions before publication. - Use Case: A product manager needs to write a decision doc for a new architecture. The Skill gathers project context, drafts each section through brainstorming and curation, then tests the doc against realistic reader questions to expose gaps. ## Quick Start Ask the assistant to help you write a design doc or proposal using the structured co-authoring workflow, starting with context gathering.

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 technical design doc with AI assistance?

Use a structured co-authoring workflow: first dump all project context while the AI asks clarifying questions, then draft each section through brainstorming and curation, and finally test the doc with a fresh reviewer to catch blind spots before sharing it.

How to structure a decision doc or proposal?

Start with the section containing the most unknowns, usually the core proposal or decision. Build 3-5 sections appropriate for the doc type, draft each through brainstorming 5-20 options, curate with the team, and leave summary sections for last.

Can this workflow use content from Slack or Google Docs?

Yes, if integrations or MCP connectors are available, the workflow can pull context directly from team channels and shared documents. Without connectors, you can paste relevant content manually into the conversation.

What is reader testing for documentation?

Reader testing validates a document by having a fresh reviewer with no prior context answer realistic questions about it. This exposes ambiguity, assumed knowledge, and contradictions that authors cannot see because they already understand the material.

When should I skip the structured doc workflow?

Skip it for short, informal writing where three stages of gathering, refinement, and testing add unnecessary overhead. The workflow is designed for substantial documents like specs, RFCs, and decision docs that multiple stakeholders will read.