doc-coauthoring

Guide structured co-authoring of technical specifications with context gathering and reader testing.

2|3|Updated Nov 24, 2020
One-click install
npx skills add https://github.com/loganlinn/dotfiles --skill doc-coauthoring-loganlinn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/loganlinn/dotfiles/tree/main/config/claude/skills/doc-coauthoring
Command: npx skills add https://github.com/loganlinn/dotfiles --skill doc-coauthoring-loganlinn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of creating structured documents, ensuring all necessary context is gathered, content is refined iteratively, and the final output is tested for clarity and effectiveness for its intended audience.

Core Features & Use Cases

  • Structured Workflow: Guides users through distinct stages: Context Gathering, Refinement & Structure, and Reader Testing.
  • Iterative Drafting: Facilitates section-by-section content creation with brainstorming, curation, and editing.
  • Context Management: Proactively gathers necessary background information and clarifies ambiguities.
  • Reader Testing: Simulates a new reader's perspective to identify blind spots and ensure comprehension.
  • Use Case: A product manager needs to draft a new technical specification. This Skill helps them gather requirements, brainstorm solutions, draft each section (e.g., Goals, Non-Goals, Technical Approach), and then test it with a simulated reader to catch potential misunderstandings before wider distribution.

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 specifications with an AI?

To co-author technical specifications with an AI, use a structured workflow that guides you through context gathering, iterative section refinement, and reader testing. This ensures your technical writing captures all necessary background information and clarifies ambiguities before wider distribution.

What is the best way to draft a structured proposal collaboratively?

The best way to draft a structured proposal collaboratively is to use an iterative drafting process that facilitates section-by-section content creation. This approach proactively gathers context and allows for brainstorming, curation, and editing to ensure document effectiveness.

How does simulated reader testing improve technical writing?

Simulated reader testing improves technical writing by evaluating the document from a new reader's perspective to identify blind spots. This process ensures comprehension and catches potential misunderstandings before the content reaches its intended audience.

Can I use this workflow to create decision documents?

Yes, you can use this workflow to create decision documents. The process supports integration with document artifacts and file creation, guiding you through context gathering and iterative refinement to produce clear and effective decision documents.

What do I need to start writing a technical specification document?

To start writing a technical specification document, you need to provide the initial topic or requirements. The workflow will then prompt you to gather necessary context, clarify ambiguities, and brainstorm solutions before drafting sections like Goals, Non-Goals, and Technical Approach.