doc-coauthoring

Guide structured co-authoring of technical specs, proposals, and decision docs.

1|Updated Jun 18, 2025
One-click install
npx skills add https://github.com/knopki/dotfiles --skill doc-coauthoring-knopki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/knopki/dotfiles/tree/main/home/private_dot_config/opencode/skills/doc-coauthoring
Command: npx skills add https://github.com/knopki/dotfiles --skill doc-coauthoring-knopki

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 refinement, and reader testing.
  • Contextual Understanding: Actively seeks and clarifies user input to build a comprehensive understanding of the document's purpose and audience.
  • Iterative Drafting: Facilitates section-by-section content creation with brainstorming, curation, and surgical edits.
  • Reader Validation: Simulates reader interaction to identify and fix ambiguities or blind spots before finalization.
  • Use Case: A product manager needs to draft a new feature specification. This Skill helps them gather all necessary background, brainstorm technical approaches, draft each section collaboratively, and finally test it to ensure it's clear for engineers and other stakeholders.

Quick Start

Use the doc-coauthoring skill to help me write a technical specification for a new user authentication system.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
What is the best way to co-author technical documentation collaboratively?

Collaborative technical documentation is best authored through a structured workflow of context gathering, iterative section-by-section refinement, and reader validation to ensure clarity and audience comprehension before finalization.

How do I write a technical specification for a new feature with multiple stakeholders?

Writing a technical specification with multiple stakeholders requires actively gathering and clarifying input to understand the document's purpose, then iteratively drafting and refining content section-by-section to ensure alignment and completeness.

Can I use this workflow to draft proposals and decision documents, not just technical specs?

Yes, you can use this workflow to draft proposals and decision documents. The co-authoring process supports various structured document types by facilitating contextual input gathering, iterative editing, and reader comprehension testing.

How does reader validation work when refining a document draft?

Reader validation works by simulating reader interaction with the drafted document to identify and fix ambiguities or blind spots. This multi-stage process ensures the final content achieves high clarity and reader comprehension.

Do I need any specific tools or dependencies to start co-authoring documents?

No specific tools or dependencies are required to start co-authoring documents. The workflow guides users through brainstorming, curating, and applying surgical edits to content natively without relying on external components.