doc-coauthoring

Guide structured co-authoring of long-form documents from rough ideas to reader-ready drafts.

Updated Dec 21, 2025
One-click install
npx skills add https://github.com/ai-wes/glassbox-operator --skill doc-coauthoring-ai-wes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-coauthoring
Source: https://github.com/ai-wes/glassbox-operator/tree/main/skills/skills/doc-coauthoring
Command: npx skills add https://github.com/ai-wes/glassbox-operator --skill doc-coauthoring-ai-wes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps people turn scattered ideas and partial context into clear, structured documents that are easier to draft, refine, and review.

Core Features & Use Cases

  • Guided Co-Authoring: Leads you through a staged workflow for context gathering, section planning, drafting, and revision.
  • Document Types: Works well for technical specs, decision docs, proposals, PRDs, RFCs, and similar long-form writing tasks.
  • Reader Testing: Checks whether the document is understandable to someone without background context before it is shared broadly.

Quick Start

Use the doc-coauthoring skill to help me draft a technical spec for a new internal workflow.

Frequently Asked Questions about doc-coauthoring

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

FAQPage Schema
How do I turn rough ideas into reader-ready technical specs?

To turn rough ideas into reader-ready technical specs, use a structured co-authoring workflow that gathers context, drafts sections iteratively, and applies fresh-reader testing to expose gaps before finalizing.

What is the best way to draft a PRD or RFC from partial context?

Drafting a PRD or RFC from partial context works best with staged questioning and placeholder scaffolding, allowing you to build long-form documents section by section while refining details through iterative edits.

Can I use this for writing decision docs and technical proposals?

Yes, you can use it for writing decision docs and technical proposals. The guided workflow supports long-form writing tasks including proposals, technical specs, PRDs, RFCs, and similar structured documentation.

How do I check if my documentation is understandable without background context?

To check if your documentation is understandable without background context, perform fresh-reader testing. This validation process exposes gaps and contradictions before you share the document broadly.

What are the limitations of co-authoring long-form documentation iteratively?

A limitation of iterative co-authoring for long-form documentation is that it requires staged questioning and active refinement. Without completing the section-by-section validation and reader testing, structural contradictions may persist.