orc-doc

Write long structured documents like PRDs and TSDs as portable Markdown via section-based orchestration.

6|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/azure-id/orc --skill orc-doc-azure-id
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orc-doc
Source: https://github.com/azure-id/orc/tree/main/templates/skills/orc-doc
Command: npx skills add https://github.com/azure-id/orc --skill orc-doc-azure-id

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing a long document such as a PRD, TSD, or runbook inside a single AI session exhausts context, loses progress when a session dies, and cannot be resumed later. This Skill writes long documents section-by-section with each section stored as its own file, so work survives session limits and resumes months later without re-explaining anything. ## Core Features & Use Cases - Section-based writing pipeline: Each section lives in its own file under sections/ as the source of truth, and document.md is rebuilt from them for free with orc doc compile. - Bounded agent dispatch: The orchestrator never reads the document body; writers each own exactly one file and checkers each read one bounded part, keeping context usage small even for 10,000-line documents. - Resumable waves with cost control: Every wave is a stop, partial mode writes one wave before you pay for the rest, and RESUME.md lets a fresh session continue exactly where it stopped. - Free deterministic linting: Rules like no questions in the body, N/A instead of filler, and no local-only references run without model tokens before any paid check. - Use Case: Ask it to write a PRD for a checkout refund feature; it interviews you once, freezes the context to disk, writes the document in waves you can review, and hands you a Markdown file that imports cleanly into Notion, Google Docs, or GitHub. ## Quick Start Ask the assistant to write a PRD for your feature using /orc-doc and answer the short intake questions about purpose, audience, and template.

Frequently Asked Questions about orc-doc

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

FAQPage Schema
How do I write a PRD or TSD with an AI assistant without losing progress?▼

Use /orc-doc with a short description of what you want written. It stores each section as its own file under sections/, writes in waves that stop for your review, and saves a RESUME.md so a new session can continue months later without re-asking anything.

What document types does orc-doc support?▼

It ships five base templates: prd, tsd, collaboration, report, and workflow. You can also supply your own template file, whose headings become the outline and are locked by default so writers cannot add or rename headings.

Can I resume a document after my session or usage limit ends?▼

Yes. Run /orc-doc resume to list documents or /orc-doc resume <prefix> to open one. The section files on disk are the progress, and the new session reads the frozen context, names sections you edited, and asks what should change before doing any work.

Does the generated Markdown import into Notion or Google Docs?▼

Yes. The output is portable Markdown checked by a free lint pass against real product limits for targets like Notion, Obsidian, Google Docs, Coda, Craft, and GitHub. The lint also blocks local-only references and questions left in the body.

How does orc-doc control the cost of writing a long document?▼

It shows a forecast of waves, agents, and token ranges once before the first paid wave, and partial mode writes only one wave before stopping for your review. Free deterministic checks always run before any paid model check.

What are the limitations of orc-doc?▼

It is not a research tool and never invents facts; missing information is recorded as a gap instead. It never edits source code, never stages or commits, and repair rounds are capped at two before it reports what remains open.