doc-coauthoring

Guide structured co-authoring of technical specifications, proposals, and decision documents.

5|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/mfmezger/ai_agent_dotfiles --skill doc-coauthoring-mfmezger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/mfmezger/ai_agent_dotfiles/tree/main/shared/skills/doc-coauthoring
Command: npx skills add https://github.com/mfmezger/ai_agent_dotfiles --skill doc-coauthoring-mfmezger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • Structured Workflow: Guides users through context gathering, iterative refinement, and reader testing.
  • Contextual Understanding: Ensures the AI has all necessary background information.
  • Iterative Drafting: Builds documents section by section with user feedback.
  • Reader Validation: Tests the document's clarity and effectiveness for its intended audience.
  • Use Case: A product manager needs to draft a new feature specification. This Skill helps them gather all necessary context, brainstorm sections, draft the content iteratively, and finally test it to ensure it's clear for engineers and other stakeholders.

Quick Start

Guide me through co-authoring 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 specifications and proposals with an AI?

You can co-author technical specifications by following a structured workflow that guides you through context gathering, iterative section drafting, and reader validation to ensure clarity. The process builds documents section by section using your feedback.

What is the best way to draft a new feature specification for engineers?

The best way to draft a feature specification is to first gather all necessary background context, then iteratively draft the content section by section. Finally, perform reader validation to test the document's clarity and effectiveness for its intended engineering audience.

Can I use this workflow to create decision documents iteratively?

Yes, you can use this workflow to create decision documents iteratively. It supports building various structured documents section by section, allowing you to refine proposals and technical specifications through continuous feedback and targeted contextual understanding.

Does the co-authoring workflow test document clarity for stakeholders?

Yes, the co-authoring workflow includes a reader validation phase specifically designed to test a document's clarity and effectiveness. This ensures your technical writing is comprehensible and effective for its intended audience of stakeholders and engineers.

Do I need to provide background context before drafting a proposal?

Yes, you need to provide background context before drafting a proposal. The workflow relies on contextual understanding to ensure the AI has all necessary information, which facilitates accurate iterative drafting and effective reader testing.