doc-coauthoring

Coordinate a three-stage co-authoring workflow for documentation with checkpoints and artifact-based review.

Updated Dec 12, 2025
One-click install
npx skills add https://github.com/Siyeolryu/ica-SYR- --skill doc-coauthoring-siyeolryu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/Siyeolryu/ica-SYR-/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/Siyeolryu/ica-SYR- --skill doc-coauthoring-siyeolryu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided workflow to co-author documentation, reducing back-and-forth and ensuring clarity and consistency across teams.

Core Features & Use Cases

  • Context Gathering: collect relevant context, goals, and constraints before drafting.
  • Refinement & Structure: iterative section creation with brainstorming, outline refinement, and line-edit cycles.
  • Reader Testing: validate drafts with a fresh perspective to surface ambiguities and assumptions.
  • Use Cases: drafting technical specs, design proposals, PRDs, decision documents, or policy papers in collaborative environments.

Quick Start

Choose the document type and audience, then start Stage 1 to gather context and proceed through Stage 2 and Stage 3.

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 team?

To co-author technical specs and proposals, use a structured workflow with Context Gathering, Refinement & Structure, and Reader Testing stages. This process enforces checkpoints for clarifying questions and iterative drafting to ensure documentation clarity.

What is the best way to structure collaborative documentation across multiple iterations?

The best way to structure collaborative documentation is using an iterative three-stage process: collect context and constraints, refine outlines through brainstorming and line-edit cycles, then validate drafts via reader testing to surface ambiguities.

How does reader testing improve the quality of decision documents?

Reader testing improves decision documents by validating drafts with a fresh perspective, explicitly surfacing hidden assumptions and ambiguities through artifact-based review, which ensures the final text is readable and correct.

Can I use this coauthoring workflow for drafting policy papers and PRDs?

Yes, you can use this coauthoring workflow for drafting policy papers, PRDs, design proposals, and decision documents. It applies to any collaborative setting requiring structured context gathering and iterative refinement.

Do I need any specific tools or dependencies to start structured doc coauthoring?

No specific tools or dependencies are required to start structured doc coauthoring. You simply choose your document type and audience, then proceed through the three guided workflow stages to produce your drafts.

Why does collaborative documentation often require excessive back-and-forth revisions?

Collaborative documentation requires excessive back-and-forth when lacking a structured coauthoring workflow. Enforcing explicit checkpoints for context gathering, iterative refinement, and reader testing reduces misalignment and ensures consistency across teams.