doc-coauthoring
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
Why use this skill?
Use the OpenClaw doc-coauthoring skill to create high-quality technical specs, proposals, and decision documents through a structured, iterative, and proven workflow.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/seanphan/doc-coauthoringWhat This Skill Does
The doc-coauthoring skill provides a structured, iterative framework for professional documentation creation within the OpenClaw environment. It transforms the AI from a simple drafting tool into a collaborative partner that guides you through a rigorous three-stage process: Context Gathering, Refinement & Structure, and Reader Testing. By forcing a clear alignment between your intent and the resulting text, this skill minimizes ambiguity, ensures logical flow, and prepares your documents for high-impact distribution. It is specifically designed for complex professional outputs like PRDs, technical specs, and decision documents.
Installation
You can install this skill by running the following command in your terminal:
clawhub install openclaw/skills/skills/seanphan/doc-coauthoring
Use Cases
- Technical Documentation: Drafting architecture decision records (ADRs) or technical specifications that require stakeholder buy-in and clear justification.
- Business Proposals: Creating persuasive project proposals where understanding the audience and desired impact is critical to success.
- Team Alignment: Writing decision documents that need to explain the 'why' behind a change, covering team dynamics, constraints, and alternatives considered.
- Cross-functional Communication: Drafting collaborative content that requires gathering scattered context from multiple sources and synthesizing it into a cohesive narrative.
Example Prompts
- "I need to write a technical spec for our new data pipeline, but I'm not sure where to start. Can we use the doc-coauthoring workflow?"
- "I have to draft a decision doc regarding our move to a new cloud provider. Let's get started on the context gathering stage."
- "I've written a first draft of a PRD, can you help me refine the structure and then run a reader test to see how a fresh AI perceives it?"
Tips & Limitations
- Be Exhaustive: During the Context Gathering phase, the more raw information you provide, the better the output. Include internal team politics, technical dependencies, and historical context.
- Embrace Iteration: Don't try to write the final version in the first pass. Use the Refinement & Structure phase to build section by section.
- Reader Testing is Key: The final stage acts as a quality control gate. Never skip this; it is the most effective way to identify gaps that might confuse future readers who are less familiar with the subject matter than you.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-seanphan-doc-coauthoring": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Related Skills
artifacts-builder
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
template-skill
Replace with description of the skill and when Claude should use it.
canvas-design
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
xlsx
Comprehensive spreadsheet creation, editing, and analysis with support for formulas, formatting, data analysis, and visualization. When Claude needs to work with spreadsheets (.xlsx, .xlsm, .csv, .tsv, etc) for: (1) Creating new spreadsheets with formulas and formatting, (2) Reading or analyzing data, (3) Modify existing spreadsheets while preserving formulas, (4) Data analysis and visualization in spreadsheets, or (5) Recalculating formulas
algorithmic-art
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.