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.