doc-coauthoring

Guide collaborative document creation through a three-stage writing workflow.

Updated Mar 1, 2017
One-click install
npx skills add https://github.com/TedTschopp/tedt.org --skill doc-coauthoring-tedtschopp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/TedTschopp/tedt.org/tree/main/.github/skills/doc-coauthoring
Command: npx skills add https://github.com/TedTschopp/tedt.org --skill doc-coauthoring-tedtschopp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill provides a structured, guided workflow to help teams co-author documentation, proposals, and technical specs, reducing miscommunication and rework by standardizing the writing process.

Core Features & Use Cases

  • Three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing to move from raw ideas to reader-ready documents.
  • Triggered by user intent to write documentation, proposals, or specs; supports iterative drafting, role-based reviews, and alignment checks.
  • Artifact-based collaboration: creates structured scaffolds and prompts to gather information, refine sections, and test clarity with a fresh reader perspective.

Quick Start

Offer and guide the user through the three-stage workflow—Context Gathering, Refinement & Structure, and Reader Testing—to produce a complete, reader-ready document.

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 documentation to improve reader comprehension?

Structure collaborative documentation using a three-stage workflow: Context Gathering, Refinement & Structure, and Reader Testing. This process moves raw ideas into reader-ready documents through iterative drafting and alignment checks.

What is the best way to co-author technical specs without causing rework?

The best way to co-author technical specs without rework is applying a standardized writing process with structured scaffolds. This gathers information, refines sections, and tests clarity using a fresh reader perspective to reduce miscommunication.

Can I use templates for team proposal writing and iterative drafting?

Yes, you can use templates for team proposal writing. The workflow creates structured scaffolds and prompts that support iterative drafting and role-based reviews to align team members throughout the documentation process.

How does reader testing work for decision docs during collaborative work?

Reader testing for decision docs works by evaluating clarity through a fresh reader perspective at the final stage. It checks whether the structured content effectively communicates intent to its intended audience before publication.

What do I need to start co-authoring documentation with my team?

To start co-authoring documentation, you need a user intent to write specs or proposals and a willingness to engage with onboarding prompts. The workflow guides the team through context gathering to produce complete documents without prior setup.