skills.rest
hidariutiwa
hidariutiwaCOMMUNITY
Explore all skills by this author →
GitHub

doc-coauthoring

Guide structured document drafting through context gathering, refinement, and reader testing.

Updated Mar 28, 2026
Search Tags:#documentation#technical writing#co-authoring#workflow guidance#reader testing#proposal drafting
One-click install
npx skills add https://github.com/hidariutiwa/flask-learning --skill doc-coauthoring-hidariutiwa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/hidariutiwa/flask-learning/tree/main/.claude/skills/doc-coauthoring
Command: npx skills add https://github.com/hidariutiwa/flask-learning --skill doc-coauthoring-hidariutiwa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unstructured document drafting often leads to missing context, unclear structure, and gaps that make documents ineffective for stakeholders, wasting time on revisions and miscommunication.

Core Features & Use Cases

  • 3-Stage Guided Workflow: Walks users through Context Gathering, iterative Refinement & Structure, and Reader Testing to ensure documents are complete and clear.
  • Iterative Section Building: Breaks document creation into manageable section-by-section brainstorming, curation, and refinement to avoid overwhelm and improve quality.
  • Use Case: Use this Skill to draft a technical decision document for your team, ensuring all tradeoffs are captured, the structure is logical, and the final document passes reader testing to catch blind spots before sharing.

Quick Start

Ask the AI to guide you through co-authoring a structured technical proposal for your new project.

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 structure a technical proposal for stakeholders?▼

Technical proposal structuring requires a guided workflow that captures full context, breaks content into manageable sections for iterative refinement, and validates final clarity through reader testing to prevent stakeholder miscommunication.

How do I draft a technical specification without missing key context?▼

Draft technical specifications using a three-stage workflow: gather full context upfront, iteratively refine the document section by section, and perform reader testing to identify blind spots and missing context before sharing with stakeholders.

Why does unstructured document drafting lead to ineffective stakeholder communication?▼

Unstructured document drafting causes ineffective communication because it lacks a repeatable workflow for context gathering and clarity validation, resulting in missing tradeoffs, logical gaps, and documents requiring constant revision.

Can I use a co-authoring workflow for individual contributor decision documents?▼

Yes, a co-authoring workflow supports individual contributors drafting decision documents by guiding them through context capture, iterative section refinement, and reader testing to ensure complete, clear content for stakeholders.

How to catch blind spots in a technical writing draft before sharing?▼

Catch blind spots in technical writing drafts by applying a reader testing phase as the final workflow step, validating document structure and content clarity for external readers to ensure effectiveness before final sharing.

Related Skills

Explore More Content & Communication Skills→
b566776b566776

bmad-market-research

Define market research scope, methodology, and data sources with web-verified evidence.

Community
Advanced
wilfozwilfoz

create-rfc

Create structured RFC documents with proposals, alternatives, criteria, and stakeholder roles.

Community
Advanced
BEIRUXBEIRUX

doc-coauthoring

Guide collaborative drafting of technical specs, proposals, and decision records.

Official
Intermediate
PracticalSwanPracticalSwan
7

documentation-authoring

Generate structured PRDs, technical specifications, design documents, and decision records.

Community
Intermediate