skills.rest
ZanebonoAlter
ZanebonoAlterCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

doc-coauthoring

Guide structured documentation co-authoring through context gathering, refinement, and reader testing.

19|4|Updated Jan 11, 2026
Search Tags:#workflow#documentation#collaboration#coauthoring#reader-testing#artifact-management#stage-based
One-click install
npx skills add https://github.com/ZanebonoAlter/Syntopica --skill doc-coauthoring-zanebonoalter
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/ZanebonoAlter/Syntopica/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/ZanebonoAlter/Syntopica --skill doc-coauthoring-zanebonoalter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, repeatable workflow to guide users through co-authoring documentation, proposals, and related artifacts, reducing context loss and enhancing collaboration.

Core Features & Use Cases

  • Context Gathering: prompts for essential context, questions, and clarifications to align all collaborators.
  • Refinement & Structure: builds sections iteratively with brainstorming, curation, and surgical edits.
  • Reader Testing: performs a structured test to verify readability and catch gaps for readers.
  • Artifact scaffolding: creates section skeletons and templates to accelerate drafting.
  • Collaboration workflows: supports iterative feedback loops and versioned updates.

Quick Start

Start Stage 1 by offering the co-authoring workflow and asking clarifying questions to gather context.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is a structured workflow for co-authoring technical documentation?▼

A structured co-authoring workflow guides collaborators through Context Gathering, Refinement & Structure, and Reader Testing to reduce context loss and ensure documentation quality.

How do I start co-authoring a proposal to align all collaborators?▼

Start co-authoring by entering Stage 1, where the workflow prompts you with clarifying questions to gather essential context and align all collaborators before drafting begins.

Can I use this workflow for technical specs and decision docs?▼

Yes, the workflow supports writing technical specs, decision docs, and proposals by applying stage-based guidance, artifact scaffolding, and iterative refinement loops to structure content.

What is the best way to verify readability and catch gaps in documentation?▼

The best way to verify readability is through Stage 3 Reader Testing, which performs a structured test to validate readers can understand the doc and identifies any existing gaps.

How do I build documentation sections iteratively during co-authoring?▼

You build documentation sections iteratively during Stage 2 Refinement & Structure, which uses brainstorming, curation, surgical edits, and artifact scaffolding to accelerate drafting.

Does the documentation workflow support versioned updates and feedback loops?▼

Yes, the collaboration workflow supports iterative feedback loops and versioned updates to manage artifact scaffolding and continuous refinement across all three stages.

Related Skills

Explore More Content & Communication Skills→
CurtisTheCurtisThe
4

tdd-design

Orchestrate TDD design conversations and generate design.md artifacts.

Community
Advanced
lemulemu

doc-coauthoring

Orchestrate structured documentation co-authoring with context gathering, refinement, and reader testing.

Community
Advanced
vardhan-harshavardhan-harsha

doc-coauthoring

Guide collaborative documentation through context gathering, refinement, and reader testing.

Community
Advanced
bodangrenbodangren
11

spec-authoring

Generate and refine technical specification drafts from feature names and review comments.

Community
Intermediate