Skip to content
Back to search

agent-orchestration

MarketplaceWorks with Claude CodeGitHub

Quota-aware orchestration skill for coding agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/osnoser1/agent-orchestration with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/osnoser1/agent-orchestration'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/osnoser1--agent-orchestration/badge.svg)](/listings/osnoser1--agent-orchestration)

HTML

<a href="/listings/osnoser1--agent-orchestration"><img src="/api/listings/osnoser1--agent-orchestration/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Use the current [Node.js LTS](https://nodejs.org/en/about/previous-releases) for the installer, which itself needs Node.js 22.20 or later ([`skills`](https://github.com/vercel-labs/skills)).

npx skills add osnoser1/agent-orchestration --skill agent-orchestration -g
npx skills update agent-orchestration
npx skills remove agent-orchestration

For project-level installs, omit `-g`.

| Harness | User-level path | Native install option | Config-dir override | |---|---|---|---| | Antigravity | `~/.gemini/antigravity/skills/` (or `~/.agents/skills/`) | Copy `skills/agent-orchestration/` or pass `-a antigravity` | — (project `.agents/skills/`) | | Claude Code | `~/.claude/skills/` | `/plugin marketplace add osnoser1/agent-orchestration` then `/plugin install agent-orchestration@agent-orchestration` | `CLAUDE_CONFIG_DIR` (symlink `~/.agents/skills/agent-orchestration` into `$CLAUDE_CONFIG_DIR/skills/`) | | Codex | `~/.agents/skills/` | `codex plugin marketplace add osnoser1/agent-orchestration` then `codex plugin add agent-orchestration@agent-orchestration` (also ships `agents/openai.yaml`) | `CODEX_HOME` | | Gemini CLI | `~/.gemini/skills/` (or `~/.agents/skills/`) | `gemini skills install` or pass `-a gemini-cli` | — (project `.gemini/skills/`) | | T3 Code | Inherits linked provider harness skill paths | Uses each linked provider's skill install | Per-provider (`CLAUDE_CONFIG_DIR`, `CODEX_HOME`) | | Others via `skills` | Harness-specific path managed by `npx skills` | `npx skills add osnoser1/agent-orchestration --skill agent-orchestration -g -a <harness>` | Per-harness |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "agent-orchestration",
  3. "description": "Quota-aware orchestration skill for coding agents",
  4. "owner": { "name": "osnoser1" },
  5. "plugins": [
  6. {
  7. "name": "agent-orchestration",
  8. "source": "./",
  9. "description": "Route work to subagents and models by task complexity, risk and remaining provider quota, with quality gates.",
  10. "skills": ["./skills/agent-orchestration"]
  11. }
  12. ]
  13. }
README.md · README · 130 lines
  1. # agent-orchestration
  2. An [Agent Skill](https://agentskills.io/specification) that turns a coding-agent conversation into a **quota-aware orchestrator**: it routes work to subagents and models by task complexity, risk, and live provider quota, and enforces quality gates (red→green evidence, cross-family review, and a cheap final check by the orchestrator).
  3. Works in multi-provider harnesses and inside single-provider harnesses. Models are read from harness discovery and `catalog.yaml`.
  4. ## How it is organized
  5. | File | What | Changes |
  6. |---|---|---|
  7. | `skills/agent-orchestration/SKILL.md` | Process steps with completion criteria: discover → classify → choose → brief → gates → land | rarely |
  8. | `skills/agent-orchestration/catalog.yaml` | Shared model facts: Artificial Analysis scores per effort, cost class, strengths, quirks | PRs |
  9. | `~/.config/agent-orchestration/assets.yaml` | **Your** providers, probe config, policy, preferences, and live quota state (outside the repo; template: `skills/agent-orchestration/assets/assets.example.yaml`) | automatic probe / you |
  10. | `skills/agent-orchestration/references/` | Selection & fallback rules, batching & supervision loop, verification & design checkpoints, repo policy contract, delegation surface & harness matrix, brief template, quota probe/error rules, unrated-model research, improvement loop | rarely |
  11. | `skills/agent-orchestration/scripts/orch.py` | **Optional**, stdlib-only Python 3.9+ helper (`probe`, `select`, `followups`, `log`, `exhaust`, `status`, `check`) | rarely |
  12. Selection in brief (rules live in `skills/agent-orchestration/references/selection.md`): complexity × risk sets a tier floor; usable rated models that meet it are ranked by preferred strength or family, quota health, policy, reset time, cost, and effort; the reviewer is chosen when its step starts, capability before independence. Two preferences cover shortfalls: `preferences.ui_fallback` (`proceed|defer|ask`) when a preferred UI/UX or family model is exhausted, and `preferences.below_tier` (`stage|wait|proceed`, default `stage`) when every tier-meeting model is out of quota, where `stage` prepares on a below-tier model and switches the same child to the tier-meeting model for the change and review.
  13. Emergency models, `max`/`ultra` efforts, and pay-per-use APIs require one explicit approval. A missing assets file falls back to defaults (all discovered providers `ok`, policy `normal`) and reports that in one line.
  14. ## Install
  15. Use the current [Node.js LTS](https://nodejs.org/en/about/previous-releases) for the installer, which itself needs Node.js 22.20 or later ([`skills`](https://github.com/vercel-labs/skills)).
  16. ```bash
  17. npx skills add osnoser1/agent-orchestration --skill agent-orchestration -g
  18. npx skills update agent-orchestration
  19. npx skills remove agent-orchestration
  20. ```
  21. For project-level installs, omit `-g`.
  22. | Harness | User-level path | Native install option | Config-dir override |
  23. |---|---|---|---|
  24. | Antigravity | `~/.gemini/antigravity/skills/` (or `~/.agents/skills/`) | Copy `skills/agent-orchestration/` or pass `-a antigravity` | — (project `.agents/skills/`) |
  25. | Claude Code | `~/.claude/skills/` | `/plugin marketplace add osnoser1/agent-orchestration` then `/plugin install agent-orchestration@agent-orchestration` | `CLAUDE_CONFIG_DIR` (symlink `~/.agents/skills/agent-orchestration` into `$CLAUDE_CONFIG_DIR/skills/`) |
  26. | Codex | `~/.agents/skills/` | `codex plugin marketplace add osnoser1/agent-orchestration` then `codex plugin add agent-orchestration@agent-orchestration` (also ships `agents/openai.yaml`) | `CODEX_HOME` |
  27. | Gemini CLI | `~/.gemini/skills/` (or `~/.agents/skills/`) | `gemini skills install` or pass `-a gemini-cli` | — (project `.gemini/skills/`) |
  28. | T3 Code | Inherits linked provider harness skill paths | Uses each linked provider's skill install | Per-provider (`CLAUDE_CONFIG_DIR`, `CODEX_HOME`) |
  29. | Others via `skills` | Harness-specific path managed by `npx skills` | `npx skills add osnoser1/agent-orchestration --skill agent-orchestration -g -a <harness>` | Per-harness |
  30. ## Automatic quota tracking
  31. Copy the example assets file (override the path with `$AGENT_ORCHESTRATION_ASSETS`):
  32. ```bash
  33. mkdir -p ~/.config/agent-orchestration
  34. curl -fsSL https://raw.githubusercontent.com/osnoser1/agent-orchestration/main/skills/agent-orchestration/assets/assets.example.yaml \
  35. -o ~/.config/agent-orchestration/assets.yaml
  36. ```
  37. During discovery, `orch.py probe` updates `used_percent`, `window`, and `resets_at` automatically, marks providers `low` at `>=85%` (configurable via `preferences.low_threshold`) and `exhausted` at `>=98%` (configurable via `preferences.exhausted_threshold`), and clears expired lockouts back to `ok`:
  38. - **Antigravity**: queries `agy -p "/usage" --output-format json < /dev/null` (zero-token cost; requires one-time sign-in in the interactive `agy` TUI) and persists per-group quotas under `groups:` so an exhausted model group excludes only its models; otherwise reports `unverified`.
  39. - **Claude**: calls `GET https://api.anthropic.com/api/oauth/usage` per configured directory (`~/.claude` and any `$CLAUDE_CONFIG_DIR` via `probe: {kind: claude, config_dir: ...}`). Credentials stay local and are omitted from logs, `assets.yaml`, and the shared usage cache (`usage-cache/`, reused for `preferences.usage_cache_ttl_seconds`, default 300; `probe --fresh` skips it); missing tokens or HTTP 401 report `unverified`, and HTTP 429 backs off until `Retry-After` passes.
  40. - **Codex**: scans today + yesterday `$CODEX_HOME/sessions/YYYY/MM/DD/rollout-*.jsonl` `token_count` events (`payload.rate_limits.{primary,secondary}`), ignoring expired windows (`resets_at <= now`).
  41. When a child hits a quota error mid-run, the skill parses the reset time (`orch.py exhaust`), switches to the next candidate, and resends the brief with partial results.
  42. *Manual fallback*: for facts no tool exposes (cancelling a plan, renewal dates, manual resets), tell the agent in plain language (e.g., `"I cancelled Codex, ends Nov 30"` or `"Claude reset"`); see `references/assets-updates.md`.
  43. ## Optional helper
  44. ```bash
  45. python3 skills/agent-orchestration/scripts/orch.py probe
  46. python3 skills/agent-orchestration/scripts/orch.py select --complexity hard --risk high \
  47. --available antigravity:gemini-4-neon,claude:claude-opus-5-5,codex:gpt-6-2-sol
  48. python3 skills/agent-orchestration/scripts/orch.py select --complexity standard --risk low --ui --ref "PR #42" \
  49. --available claude:claude-sonnet-5-5,antigravity:gemini-4-neon
  50. python3 skills/agent-orchestration/scripts/orch.py followups --due
  51. python3 skills/agent-orchestration/scripts/orch.py log --complexity hard --risk high \
  52. --provider antigravity --model gemini-4-neon --effort high --outcome ok --findings 1 --repo my-app
  53. python3 skills/agent-orchestration/scripts/orch.py exhaust antigravity "Individual quota reached… Resets in 4h29m1s"
  54. python3 skills/agent-orchestration/scripts/orch.py status claude ok
  55. python3 skills/agent-orchestration/scripts/orch.py check
  56. ```
  57. Exit codes: `0` ok · `1` error · `2` no tier match · `3` blocked by pre-flight threshold or policy gate (`low` ≥85%, gated, or `ui_fallback: defer|ask`) · `4` quota hit (`exhausted` / ≥98%).
  58. ## Extending per repository
  59. All extension points live at two layers:
  60. 1. **Per-repository policy (`AGENTS.md` `## Orchestration`)** — add an optional section to any target repository's `AGENTS.md` (read directly by supported harnesses) to override process defaults, extra high-risk paths, model preferences, conversation guidance, verification evidence, design checkpoints, and known infrastructure failure remedies. Every line is optional; absent sections use defaults. See `skills/agent-orchestration/references/repo-policy.md`.
  61. ```markdown
  62. ## Orchestration
  63. Repository policy for the agent-orchestration skill; it overrides the skill's defaults here.
  64. - Implement: <skill names or guide>
  65. - Review: <skill names>
  66. - PR: <skill name>
  67. - Land: <command or process>
  68. - High risk: <extra paths/areas that count as high risk>
  69. - Models: <task-type preferences, e.g. UI/UX work → Anthropic>
  70. - Conversations: <when new top-level conversations are preferred or restricted>
  71. - Evidence: <verification evidence by change type, e.g. UI changes require browser screenshots>
  72. - Checkpoints: <user-visible surfaces or taste decisions that trigger a design checkpoint>
  73. - Known failures: <known transient/infra failure signatures and their one-rerun or remedy command>
  74. ```
  75. 2. **Per-user configuration (outside git)** — lives in `~/.config/agent-orchestration/` (or beside `$AGENT_ORCHESTRATION_ASSETS`):
  76. - `assets.yaml`: your providers, probe config, policies, live quota state, `preferences.ui_fallback` (`proceed|defer|ask`), `preferences.below_tier` (`stage|wait|proceed`), `preferences.new_conversations` (`ask|allow`), `preferences.design_checkpoints` (`ask|delegate`), `preferences.evidence`, `preferences.tier_floors`, and deferred `followups`.
  77. - `catalog.local.yaml`: local model ratings or overrides merged on top of `catalog.yaml`.
  78. - User-local batch plans / durable supervision summaries (e.g. `~/.config/agent-orchestration/plans/`): kept outside repositories and public trackers (`skills/agent-orchestration/references/supervision.md`).
  79. **Precedence**: explicit user instruction > `assets.yaml` (quota, pay-per-use, emergency spending, conversation authorization, design-checkpoint gate, user evidence priorities) and harness rules > target repo `## Orchestration` (phase skills/commands, high-risk paths, model preferences, repo evidence expectations, checkpoint triggers, known failure remedies) > skill defaults.
  80. ## Improving the skill
  81. Consumer repositories feed orchestration findings back upstream rather than patching installed skill copies locally (`skills/agent-orchestration/references/improvement.md`):
  82. - **Decision ledger**: `orch.py log` appends one structured JSON line per delegation (selection + completion) to `ledger.jsonl` next to `assets.yaml` — timestamp, repo basename, delegation surface (`subagent|conversation`), task class, chosen model/effort, reviewer, outcome (`ok|failed|quota|stall|rework`), and review findings count. Prompts, code, secrets, full paths, and personal data are never recorded.
  83. - **Retrospective findings**: during a repo's retrospective (`retro` / `retro-dispatch`), file an upstream issue on `osnoser1/agent-orchestration` using `.github/ISSUE_TEMPLATE/retro-finding.md` with ledger evidence for wrong model/effort choices, quota surprises, stalled children, brief gaps, or missing harness quirks. Submit new or updated model ratings as a PR editing `skills/agent-orchestration/catalog.yaml` with `orch.py check` passing.
  84. - **Keeping installs current**: check and update at the start of every retrospective (or weekly):
  85. - Global install: `npx skills check -g` then `npx skills update agent-orchestration -g` (add `-y` for non-interactive runs).
  86. - Project install: `npx skills check -p` then `npx skills update agent-orchestration -p`.
  87. - `orch.py check` also performs an offline staleness check on local skill lockfiles (`~/.agents/.skill-lock.json` and `./skills-lock.json`) and suggests updating when an install is older than 7 days.
  88. ## Contributing
  89. To add or re-rate models, edit `skills/agent-orchestration/catalog.yaml` (scores per effort, `source`, retrieval date, `confidence`; `rating: unrated` when data is unavailable), run `python3 skills/agent-orchestration/scripts/orch.py check`, and open a PR. Keep personal quota data, emails, and private project names out of commits.
  90. ## Standards followed
  91. - [Agent Skills specification](https://agentskills.io/specification) (validated with `skills-ref`)
  92. - [`skills` installer layout](https://github.com/vercel-labs/skills/blob/main/docs/creating-skills.md) (`skills/<name>/SKILL.md`)
  93. - [Claude Code plugin marketplace format](https://code.claude.com/docs/en/plugin-marketplaces) (`.claude-plugin/marketplace.json`)
  94. - Codex/agent plugin marketplace and UI metadata (`.agents/plugins/marketplace.json`, `skills/agent-orchestration/agents/openai.yaml`)
  95. MIT licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.