# Delegate

> Turn Claude Code into a multi-model orchestration and delegation system. FIRST discovers which model CLIs and Claude models are available on THIS machine, then builds a customized "right model for the right job" routing config plus opt-in subagents that delegate work to external models (Codex/GPT, Gemini, OpenRouter, Ollama, local, etc.) and report results back. Use when a user wants to set up mo…

- **Type:** Skill
- **Install:** `agentstack add skill-ominou5-agentic-workflows-delegate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ominou5](https://agentstack.voostack.com/s/ominou5)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ominou5](https://github.com/ominou5)
- **Source:** https://github.com/ominou5/agentic-workflows/tree/main/Skills/delegate
- **Website:** https://www.skool.com/agashic-5136

## Install

```sh
agentstack add skill-ominou5-agentic-workflows-delegate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🔀 /delegate — Multi-Model Orchestration & Delegation

Turn Claude Code into an **orchestrator**: it hands the right work to the right
model — cheap models for bulk, premium for taste, local for private, other
providers for breadth — then reports results back. Two ideas underpin it:

1. **Right model for the right job** — route by cost / intelligence / taste, and
   *escalate rather than cheap out* when output misses the bar.
2. **Delegate via CLIs** — Claude Code shells out to model CLIs and reports back;
   an opt-in subagent wraps each lane.

> This skill is **self-customizing**. It does NOT hardcode one person's model
> roster. It discovers what *you* actually have and builds your config around it.

---

## 🛑 FIRST RUN — SELF-CUSTOMIZATION (do this before anything else)

If `~/.claude/CLAUDE.md` has no "Model orchestration" section **and**
`~/.claude/agents/` has no delegate wrappers, this skill is unconfigured for this
machine. Execute the four steps in order. Do not skip discovery and paste a
generic roster — the whole point is to fit the user's actual setup.

### Step 1 — DISCOVER what is on THIS machine
Follow [`references/discovery.md`](references/discovery.md). Detect, without
assuming:
- External model CLIs on PATH: `codex`, `gemini`, `agy`, `ollama`, `llm`,
  `aider`, and any others.
- Local models: `ollama list` (if present).
- Which Claude models *this* Claude Code can use (current aliases + any versioned
  models exposed in the picker/config).
- Provider API keys present — **env var NAMES ONLY. Never read, print, echo, or
  store a key's value.**

Report a short table of what's available. That table is the raw material for the
routing config.

### Step 2 — ASK the user to calibrate (don't invent their economics)
Model rankings are personal — they depend on the user's plans and limits, not
list price. Ask:
1. **Which subscriptions/plans do you have?** (e.g. a Gemini subscription, a
   ChatGPT/Codex plan, OpenRouter credits, local GPU.) This decides what is
   "effectively free" vs metered for *them*.
2. **Priority when models conflict** — cost, or output quality?
3. **Any models to avoid** (unproven/untrusted for them), or a hard "never"?
4. **Scope**: global config (`~/.claude/`, every project) or one project
   (`.claude/`)? Global is convenient; project-scoped keeps unrelated/brownfield
   repos unaffected.

Fill the routing table's cost/priority from these answers. Do NOT copy example
numbers from the template.

### Step 3 — BUILD the customized setup
- For each CLI found in Step 1, copy the matching template from
  [`templates/agents/`](templates/agents/) into the chosen agents dir. Skip lanes
  for tools the user does not have.
- Write the routing framework from [`templates/CLAUDE.md`](templates/CLAUDE.md)
  into the chosen CLAUDE.md, filled with THIS user's models + priorities.
- Pin wrapper subagents to the user's **cheapest *proven* Claude model** (ask
  which — the wrappers only craft prompts and summarize, so they should be cheap).
- (Windows) if `codex` or another tool isn't on PATH, see the shim note in
  [`references/provider-setup.md`](references/provider-setup.md).

### Step 4 — VERIFY
Smoke-test one round-trip per configured lane (see
[`references/cli-invocations.md`](references/cli-invocations.md) → "Smoke test").
Each lane should return a correct, model-identified answer before you declare the
setup done. Report the results.

---

## Core principles (the routing ethos)
- **Defaults, not limits.** Judge the OUTPUT, not the price tag. If a cheaper
  model underdelivers, rerun on a stronger one without asking — escalating costs
  less than shipping mediocre work.
- **When axes conflict for anything that ships: intelligence > taste > cost.**
- **Bulk / mechanical / clear-spec** (implementation to spec, data wrangling,
  migrations, investigation) → cheapest capable model (often a GPT/Codex or a
  local model).
- **User-facing** (UI, copy, API design) or top-quality output → highest-taste model.
- **Reviews** → a couple of strong models, optionally one from a *different
  provider* for an independent lens.
- **Research / large-context / web** → a big-context model (e.g. Gemini).
- **Never** route to a model the user flagged as untrusted or "never".

## Delegation mechanics (hard-won — full detail in references/cli-invocations.md)
- **Close stdin or many CLIs hang.** Append `</dev/null` (bash / macOS / Linux /
  Git-Bash) or `<nul` (Windows `cmd`). This is the #1 cause of "it just hangs".
- **Prefer file output over stdout** when a CLI drops output on a non-TTY pipe
  (some agentic CLIs do): have it write to a file and read the file.
- **Keep delegation OPT-IN.** Subagents should fire only on explicit request and
  never auto-delegate — this protects governed/brownfield repos from silently
  routing work to an external model.
- **Dynamic spawns take aliases only.** Claude Code's on-the-fly subagent spawn
  accepts current model aliases; to run a subagent on a *versioned* model, PIN it
  in an agent file.
- **Sandbox awareness.** Claude Code's tool shell may be sandboxed/isolated from
  the host: tools *installed* by the agent may not reach the user's real machine,
  and interactive logins done in a terminal may not be visible to the agent's
  shell. Have the user install host tools and authenticate themselves; verify.
- **Report back, don't dump.** A wrapper returns a tight synthesis + the model
  used, not the raw transcript.

## Invoking (after setup)
- Natural language: "delegate this to codex", "have gemini research X",
  "use a local model for this".
- Explicit: `@codex-delegate`, `@gemini-research`, `@model-delegate`.

## Extending — add a new provider lane
Copy [`templates/agents/model-delegate.md`](templates/agents/model-delegate.md),
swap in the new CLI + flags, keep it opt-in and reliable-stdout, then add a row to
your CLAUDE.md routing table. The `llm` CLI (one tool, many providers) is the
lowest-effort way to add breadth.

## Credits
Inspired by [@theo](https://x.com/theo) (t3.gg)'s posts on model-tiering for
agent orchestration — keeping a `CLAUDE.md` section that prioritizes different
models for different work, and teaching Claude Code to use Codex (and other CLIs)
as delegation fallbacks for token-hungry tasks (implementation, computer-use,
codebase analysis) while the primary model orchestrates.

This skill generalizes that idea into a **self-discovering** setup (it detects
each user's own models/CLIs instead of hardcoding a roster) and hardens the CLI
delegation with the non-TTY / stdin-hang / versioned-model-pinning / sandbox-
isolation / opt-in lessons learned making it reliable in practice.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ominou5](https://github.com/ominou5)
- **Source:** [ominou5/agentic-workflows](https://github.com/ominou5/agentic-workflows)
- **License:** MIT
- **Homepage:** https://www.skool.com/agashic-5136

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ominou5-agentic-workflows-delegate
- Seller: https://agentstack.voostack.com/s/ominou5
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
