doc-coauthoring

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

Updated Aug 20, 2022
One-click install
npx skills add https://github.com/Neroro64/dotfiles --skill doc-coauthoring-neroro64
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/Neroro64/dotfiles/tree/main/configs/omp/agent/skill_store/doc-coauthoring
Command: npx skills add https://github.com/Neroro64/dotfiles --skill doc-coauthoring-neroro64

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, collaborative workflow for creating documentation, proposals, specifications, and related documents. It helps teams transfer context, refine content through iteration, and validate readability before sharing.

Core Features & Use Cases

  • Three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing to coordinate and improve document quality.
  • Interactive guidance: prompts and checkpoints to gather context, structure content, and test readability with a fresh reader.
  • Artifact-driven process: supports creating drafts and scaffolds, and iterative edits until content is ready for readers.

Quick Start

Initiate Stage 1: Context Gathering by collecting the user's context and requirements.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I structure co-authoring for technical documentation and proposals?

To structure co-authoring for technical documentation, this skill applies a three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. It guides teams to capture context, iteratively refine sections, and validate readability through interactive checkpoints.

What is the best way to iteratively refine technical specs with a team?

The best way to iteratively refine technical specs is using an artifact-driven process that supports creating drafts and scaffolds. It enables iterative edits and applies quality checks during the Refinement & Structure stage until the content accurately captures the required context.

How do I test readability and validate decision records before sharing?

To test readability and validate decision records before sharing, this skill uses a dedicated Reader Testing stage. It prompts you to test the structured content with a fresh reader, ensuring the document is clear and ready for its target audience.

Can I use this workflow to capture context for structured content like decision records?

Yes, you can use this workflow to capture context for structured content like decision records. Stage 1 Context Gathering specifically collects your initial context and requirements to drive the creation of proposals, specifications, and related documents.

Does structured documentation co-authoring work without external dependencies?

Yes, structured documentation co-authoring works without external dependencies. The skill operates independently to coordinate team collaboration, guide iterative refinement, and manage artifact creation without requiring additional components or external libraries.