100+ AI Agents, Agent Skills and RAG Apps - Free and Open Source.
advisor-orchestrator-worker: Anthropic API fallback for the advisor
cicf79012c65ca
diff --git a/agent_skills/advisor-orchestrator-worker/README.md b/agent_skills/advisor-orchestrator-worker/README.mdindex 11d1d600..7ee272e3 100644--- a/agent_skills/advisor-orchestrator-worker/README.md+++ b/agent_skills/advisor-orchestrator-worker/README.md@@ -32,7 +32,7 @@ npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_Or copy this folder into your agent's skills dir (`~/.claude/skills/`, `~/.codex/skills/`, `~/.agents/skills/`).-**Needs** (declared up front, per this repo's rules): the `agy` (Antigravity) CLI for workers — with `GEMINI_API_KEY` (falls back to `GOOGLE_API_KEY`) as the API fallback when agy is unavailable — plus the `claude` CLI for the advisor and `jq` for fallback payloads. Anything missing degrades gracefully — the skill explains the setup fix, then offers degraded mode where your agent plays the missing role itself, labeled as such.+**Needs** (declared up front, per this repo's rules): the `agy` (Antigravity) CLI for workers — with `GEMINI_API_KEY` (falls back to `GOOGLE_API_KEY`) as the API fallback — plus the `claude` CLI for the advisor (`ANTHROPIC_API_KEY` as its API fallback) and `jq` for fallback payloads. Every role runs on its subscription CLI when installed and falls back to its API key when not. The orchestrator is whichever agent loads the skill; to put a specific model in that seat, launch the run through its CLI (e.g. `codex exec "..."`). Anything missing degrades gracefully — the skill explains the setup fix, then offers degraded mode where your agent plays the missing role itself, labeled as such.## Use itdiff --git a/agent_skills/advisor-orchestrator-worker/SKILL.md b/agent_skills/advisor-orchestrator-worker/SKILL.mdindex d820ea44..56c5c7cf 100644--- a/agent_skills/advisor-orchestrator-worker/SKILL.md+++ b/agent_skills/advisor-orchestrator-worker/SKILL.md@@ -15,7 +15,8 @@ metadata:compatibility: >-Makes network calls: workers via the Antigravity CLI (agy), falling back tothe Gemini API (GEMINI_API_KEY or GOOGLE_API_KEY); advisor via the claude- CLI. Needs jq. Runs in any harness that can execute shell commands.+ CLI, falling back to the Anthropic API (ANTHROPIC_API_KEY). Needs jq. All+ snippets are bash. Runs in any harness that can execute shell commands.---# Advisor Orchestrator Worker@@ -27,7 +28,9 @@ work yourself, and you never execute through the advisor.**Models are knobs, not gospel.** The tiers are the durable part; themodel IDs below were current in July 2026 — swap freely. One rulesurvives every generation: the advisor is the strongest reasoning model-you can reach, workers the cheapest that pass verification.+you can reach, workers the cheapest that pass verification. All+snippets below are bash; on a host whose shell isn't bash, run them+with `bash -c`.## The team@@ -88,23 +91,45 @@ you can reach, workers the cheapest that pass verification.agy or gets ESCALATE — never pretend an API worker browsed the web ortouched a file.-- **Advisor (default: Claude Fable 5)** — consulted in print mode, the- consult written to a temp file and passed on stdin (never inline in- the command string), behind a timeout so a hung consult can't stall- the loop — via perl's alarm, since timeout(1) is missing on stock macOS:+- **Advisor (default: Claude Fable 5 via the claude CLI)** — consulted+ in print mode, the consult written to a temp file and passed on stdin+ (never inline in the command string), behind a timeout so a hung+ consult can't stall the loop — via perl's alarm, since timeout(1) is+ missing on stock macOS:`perl -e 'alarm shift; exec @ARGV' 300 claude --model claude-fable-5 -p < "$consult"`.Expensive judgment kept out of the hot path: strategy, decompositioncritique, risk spotting, taste. Never execution.+ **Fallback — bare Anthropic API call** when the claude CLI is missing+ or a consult fails. Same model, same consult file; the fallbacks+ parameter re-serves a safety-classifier refusal on Opus 4.8 inside+ the same call, and the closing jq unwraps the envelope so the+ orchestrator reads plain advisor text on both paths:++ ```bash+ [ -n "$ANTHROPIC_API_KEY" ] || { echo "no ANTHROPIC_API_KEY" >&2; exit 1; }+ ( set -o pipefail+ jq -n --rawfile c "$consult" '{model: "claude-fable-5", max_tokens: 16000,+ fallbacks: [{model: "claude-opus-4-8"}],+ messages: [{role: "user", content: $c}]}' \+ | curl -sS --fail --max-time 300 "https://api.anthropic.com/v1/messages" \+ -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" \+ -H "anthropic-beta: server-side-fallback-2026-06-01" \+ -d @- \+ | jq -r '.content[] | select(.type == "text") | .text' )+ ```+## The loop1. **Frame.** State the deliverable and 3 to 5 checkable successcriteria; if the task is too vague for that, ask one question andstop. Check tools now, not mid-run: `agy`, `jq`, the `claude` CLI,- and `api_key="${GEMINI_API_KEY:-$GOOGLE_API_KEY}"`. If agy is missing- but a key is set, announce that all workers run on the API fallback- (no tools). If a role has no working path, say exactly how to set it- up, then offer degraded mode: you temporarily play the missing role+ `ANTHROPIC_API_KEY`, and `api_key="${GEMINI_API_KEY:-$GOOGLE_API_KEY}"`.+ Each role resolves CLI first, then API key: agy missing but a Gemini+ key set means workers run on the API fallback (no tools); claude CLI+ missing but ANTHROPIC_API_KEY set means consults go over the API.+ Announce every fallback up front. If a role has no working path, say+ exactly how to set it up, then offer degraded mode: you temporarily play the missing roleyourself — same budgets, every affected section and the final resultlabeled `[DEGRADED: <role>]`, context-isolation caveat noted. This isthe one exception to the never-do-worker-work rule, and it covers atdiff --git a/agent_skills/evals/advisor-orchestrator-worker/evals.json b/agent_skills/evals/advisor-orchestrator-worker/evals.jsonindex c102d76c..289e53ec 100644--- a/agent_skills/evals/advisor-orchestrator-worker/evals.json+++ b/agent_skills/evals/advisor-orchestrator-worker/evals.json@@ -22,10 +22,11 @@},{"id": 2,- "prompt": "Fan out this refactor plan across workers, but this machine has no agy CLI, only GOOGLE_API_KEY set, and no claude CLI.",- "expected_output": "The orchestrator detects the missing tools at the frame step: workers drop to the announced Gemini API fallback, and it explains setup for the missing advisor and offers degraded mode where it plays the advisor itself, flagged as degraded.",+ "prompt": "Fan out this refactor plan across workers, but this machine has no agy CLI, only GOOGLE_API_KEY set, no claude CLI, and no ANTHROPIC_API_KEY.",+ "expected_output": "The orchestrator detects the missing tools at the frame step: workers drop to the announced Gemini API fallback, and with neither the claude CLI nor ANTHROPIC_API_KEY available it explains setup for the advisor and offers degraded mode, flagged as degraded.","expectations": ["With agy missing but a Gemini key set, workers run on the API fallback and this is announced up front, not discovered mid-run",+ "Each role resolves CLI first then API key: with the claude CLI missing but ANTHROPIC_API_KEY set, consults would run over the Anthropic API; degraded mode is offered only when neither path exists","GEMINI_API_KEY falls back to GOOGLE_API_KEY before being declared missing","Tool availability is checked at the frame step, not discovered mid-run","The user is told how to set up the missing piece",