doc-coauthoring

Guide structured document co-authoring with context gathering, iterative refinement, and reader testing.

Updated Mar 15, 2025
One-click install
npx skills add https://github.com/mrdonlee/dotfiles --skill doc-coauthoring-mrdonlee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/mrdonlee/dotfiles/tree/main/.agents/skills/doc-coauthoring
Command: npx skills add https://github.com/mrdonlee/dotfiles --skill doc-coauthoring-mrdonlee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of creating structured documents like proposals, technical specifications, and decision documents, ensuring clarity, completeness, and reader comprehension.

Core Features & Use Cases

  • Structured Workflow: Guides users through context gathering, iterative drafting, and reader testing.
  • Contextual Understanding: Actively seeks and clarifies user input to build a comprehensive understanding of the document's goals.
  • Iterative Refinement: Facilitates section-by-section drafting and editing based on user feedback.
  • Reader Simulation: Tests the document's clarity and completeness from a reader's perspective.
  • Use Case: A product manager needs to draft a new feature specification. This Skill helps them gather all necessary background, brainstorm requirements, draft each section iteratively, and finally test it to ensure it's understandable for engineers and other stakeholders.

Quick Start

Use the doc-coauthoring skill to help write a new technical specification document.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I co-author technical specification documents efficiently?

To co-author technical specification documents efficiently, use a structured workflow that guides context gathering, iterative drafting, and reader testing to ensure clarity and completeness for stakeholders.

What is the best way to draft a proposal while ensuring reader comprehension?

Drafting a proposal while ensuring reader comprehension is best achieved through iterative refinement and reader simulation, which tests the document's clarity and completeness from a reader's perspective section by section.

How do I gather context and brainstorm requirements for a feature specification?

You can gather context and brainstorm requirements for a feature specification by actively seeking and clarifying user input to build a comprehensive understanding of the document's goals before drafting begins.

Can I use this workflow to write decision documents for engineering teams?

Yes, you can use this workflow to write decision documents for engineering teams. It supports the creation of technical specifications and proposals by facilitating efficient context transfer and content iteration.

What are the limitations of using a structured workflow for content creation?

A limitation of using a structured workflow for content creation is that it requires active user participation during context gathering and iterative refinement, meaning it cannot autonomously generate documents without continuous user feedback.