skills.rest
giosuetedeschi-spec
giosuetedeschi-specCOMMUNITY
Explore all skills by this author →
GitHub

doc-coauthoring

Guide structured documentation through context gathering, iterative drafting, and reader validation.

Updated Jan 12, 2026
Search Tags:#workflow#documentation#collaboration#technical writing#drafting#co-authoring
One-click install
npx skills add https://github.com/giosuetedeschi-spec/bobu-website --skill doc-coauthoring-giosuetedeschi-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/giosuetedeschi-spec/bobu-website/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/giosuetedeschi-spec/bobu-website --skill doc-coauthoring-giosuetedeschi-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the challenge of writing high-quality, structured documentation by providing a guided, iterative workflow that ensures clarity, completeness, and reader-readiness.

Core Features & Use Cases

  • Structured Workflow: Guides users through context gathering, section-by-section drafting, and reader testing.
  • Iterative Refinement: Uses brainstorming and surgical editing to build documents that are tailored to specific audiences.
  • Reader Testing: Simulates a fresh reader perspective to identify blind spots and ambiguities before the document is finalized.

Quick Start

Initiate the doc co-authoring workflow by telling the assistant you need help drafting a new technical specification or project proposal.

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 documentation with an AI assistant?▼

To co-author technical documentation, you initiate a three-stage workflow involving context gathering, iterative section-by-section drafting, and reader-based validation to ensure audience-appropriate clarity.

What is the best way to draft a structured technical specification?▼

Drafting a structured technical specification is best handled through a guided iterative workflow that uses brainstorming and surgical editing to build documents tailored to specific audiences.

How does reader testing work for project proposals?▼

Reader testing for project proposals works by simulating a fresh reader perspective to identify blind spots and ambiguities, ensuring the document is logically complete before finalization.

Can I use this workflow to identify logical gaps in decision documents?▼

Yes, you can use this workflow to identify logical gaps in decision documents by applying its proactive reader-based validation stage to test for completeness and structural consistency.

What should I provide before drafting professional docs collaboratively?▼

Before drafting professional docs collaboratively, you should provide the core context and requirements for your technical specification, project proposal, or decision document to guide the initial gathering stage.

Related Skills

Explore More Content & Communication Skills→
diegosanchespereira1diegosanchespereira1

bmad-agent-tech-writer

Organize project knowledge into structured Markdown technical documentation.

Community
Intermediate
wangcb8i8iwangcb8i8i

revise-markdown

Identify, resolve, and remove all embedded review comments in markdown documents.

Community
Intermediate
coroboroscoroboros
2

fix-grammar

Correct grammar and spelling in Markdown and documentation files.

Official
Intermediate
TruvetaPublicTruvetaPublic
8

doc-coauthoring

Organize collaborative documentation into a three-stage workflow with reader testing.

Official
Advanced