doc-coauthoring

Guide teams through staged document creation with context gathering, refinement, and reader testing.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/Cissou34730/Azure-Architect-Assistant --skill doc-coauthoring-cissou34730
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/Cissou34730/Azure-Architect-Assistant/tree/main/.github/skills/doc-coauthoring
Command: npx skills add https://github.com/Cissou34730/Azure-Architect-Assistant --skill doc-coauthoring-cissou34730

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through a structured, collaborative workflow for creating documentation such as proposals, technical specs, decision records, and similar documents. It helps teams move from scattered notes to coherent, reader-ready artifacts.

Core Features & Use Cases

  • Context Gathering: Collects all relevant context and constraints before drafting.
  • Refinement & Structure: Iteratively builds sections, prompts clarifying questions, and collapses ideas into a clean outline.
  • Reader Testing: Validates the document with a fresh perspective to catch gaps and ambiguities.
  • Use Case: A product team drafts a design proposal by guiding contributors through context, structure, and reader validation.

Quick Start

Accept the structured co-authoring workflow and begin with Stage 1: Context Gathering by answering clarifying questions and dumping relevant context.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I structure collaborative document writing for technical specs?▼

Structured document writing for technical specs is handled through a three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. This process moves teams from scattered notes to reader-ready artifacts via iterative drafting and clarifying questions.

What is the best way to co-author a design proposal with a team?▼

Co-authoring a design proposal works best using a staged workflow that collects constraints first, iteratively builds sections, and validates with a fresh perspective. This ensures contributors align before producing the final proposal.

How do I gather context and constraints before drafting a proposal?▼

To gather context and constraints before drafting a proposal, begin with Stage 1: Context Gathering. You answer clarifying questions and dump relevant context to ensure all project constraints are collected before the outlining phase begins.

How does reader testing improve structured documentation?▼

Reader testing improves structured documentation by validating the draft with a fresh perspective to catch gaps and ambiguities. This final stage ensures the artifact is coherent and reader-ready before final publication.

Can I use this workflow for decision records across different projects?▼

Yes, this workflow applies to decision records across different projects and teams. The structured co-authoring process supports proposals, technical specs, and decision records by guiding contributors through context, structure, and reader validation.

When do I need a structured workflow for proposal writing?▼

You need a structured workflow for proposal writing when moving from scattered notes to coherent artifacts. It helps collapse ideas into a clean outline and prompts clarifying questions to ensure the final document meets reader expectations.