Doc Coauthoring

SkillProductivity

Load when a task needs to collaboratively draft, restructure, or reader-test docs, PRDs, RFCs, proposals, specs, or decision records; skip implementation itself.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Doc Coauthoring skill

What this skill tells your AI

The instructions your AI receives, as published by jasonxzwen/harness-hub in skills/doc-coauthoring/SKILL.md and read by ahel’s review.

Use this skill to help a user turn rough context into a document that works for its intended readers.

Workflow

  1. Establish the document contract: doc type, audience, desired decision or action, constraints, deadline, and existing template.
  2. Gather context before drafting. Ask only for missing facts that change structure, claims, or acceptance.
  3. Propose a short outline with section intent, not polished prose.
  4. Draft in passes: structure first, then claims and evidence, then wording.
  5. Maintain an assumptions and open-questions list while drafting.
  6. Reader-test before handoff: check whether a fresh reader can identify the decision, rationale, tradeoffs, owner, next action, and evidence.
  7. Deliver the final doc plus unresolved questions and suggested review focus.

Boundaries

  • Use product-capability when the doc is an implementation spec that must drive code changes.
  • Use internal-comms for status reports, newsletters, incident updates, FAQs, or leadership updates.
  • Answer directly for read-only explanations that do not need a durable document.
  • Do not invent facts, metrics, commitments, dates, owners, or approvals.

Signals

GitHub stars
72
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
doc-coauthoring-jasonxzwen
Source
github.com/jasonxzwen/harness-hub