orc-diy

Gates and dispatches user-compiled custom orchestrator flows built via the orc diy CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams want a custom AI orchestration pipeline — choosing which phases run (analyze, review, security, verify, testgen), which model tier executes tasks, and how autonomous the run is — without hand-editing prompts or config files in-session. This Skill enforces that the flow shape is configured only through the deterministic orc diy CLI and compiled into a flow file, then gates and dispatches that compiled flow. ## Core Features & Use Cases - Hard gate before every run: checks orc diy status and refuses to run UNCONFIGURED or STALE flows, naming the exact reason and fix (orc diy compile), with a single fallback offer to the regular /orc lane. - Compiled flow dispatch: reads .claude/orc/diy/FLOW-COMPILED.md and follows it as the orchestrator spine, honoring its tier self-gate, locked safety rules, and phase sequence. - CLI-owned configuration: all flow keys (phases, scoring, session tier, autonomy, ship mode) are set via orc diy set and compiled deterministically with zero model tokens; the Skill never edits config, lock, or compiled artifacts. - Use Case: A developer runs orc diy init --preset lean, tweaks verify to smoke, compiles, then invokes /orc-diy implement the CSV export endpoint to run their custom pipeline with the full lane's checkpoints, subagents, and evidence rules minus the phases they removed. ## Quick Start Ask the assistant to run your custom flow with "/orc-diy implement the CSV export endpoint" after compiling it with the orc diy CLI.

Frequently Asked Questions about orc-diy

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

FAQPage Schema
How do I create a custom orc flow with orc-diy?▼

Run `orc diy` for the interactive composer, or script it with `orc diy init` (optionally `--preset lean|paranoid|solo-fast`), shape keys with `orc diy set <key> <value>`, then run `orc diy compile`. After that, invoke `/orc-diy <request>` to run the compiled flow.

Why does /orc-diy refuse to run my flow?▼

The skill hard-gates on `orc diy status`: UNCONFIGURED means no config exists, and STALE means the config changed, orc was updated, or the compiled file was edited or deleted. Run `orc diy compile` to rebuild, or accept the offered fallback to the regular `/orc` lane.

Can I edit the compiled flow or config by hand?▼

No. The `orc diy` CLI is the only writer of `orc-diy.config.yaml`, `flow.lock.json`, and `FLOW-COMPILED.md`; the skill refuses to patch them conversationally. Any manual edit flips the gate to STALE via hash mismatch, blocking runs until you recompile.

Does orc-diy work without the orc skill installed?▼

No. The compiler cherry-picks phase blocks from the installed orc skill and shared phase library, verifying each referenced file exists under `.claude/skills/`. If orc is absent or incomplete, compilation aborts naming the missing file; `orc init` installs both.

What rules can never be configured away in a custom flow?▼

Locked rules compiled verbatim into every flow include: the orchestrator never implements (subagents do all work), disk is truth with checkpoint discipline, no overlapping declared_files in a wave, the P0–P3 severity ladder, and never offering commit on a red build.

How do I run a DIY flow on a specific model tier?▼

Set `session_tier` (e.g., `orc diy set session_tier opus-5-high`) and recompile; the score table is clipped to the tier at compile time. The global `opus5_only` config does not reach this lane because executors come from the compiled lock file.