From 806c24e7ef60c5f9cb23f01aee328580673e00e3 Mon Sep 17 00:00:00 2001 From: cj Date: Mon, 17 Aug 2026 16:26:01 +0000 Subject: [PATCH] Update claude-api skill: advisor pairing, reading-guide note, strip reviewer comments Small resync of the claude-api skill content: - managed-agents-multiagent.md: drop the note that Claude Fable 5 is temporarily unavailable as a Managed Agents advisor. The restriction has been lifted, so advisor pairing follows the standard table again. - SKILL.md Reading Guide: state that every {lang}/, shared/, and curl/ path is relative to the skill's base directory and must be Read on demand, since none of that content is inlined. - platform-availability.md, model-migration.md: remove two reviewer-only HTML comments that were never meant to ship in the published files. No-Verification-Needed: markdown-only skill content, no runtime surface --- skills/claude-api/SKILL.md | 2 +- .../shared/managed-agents-multiagent.md | 2 +- skills/claude-api/shared/model-migration.md | 1 - .../shared/platform-availability.md | 49 ------------------- 4 files changed, 2 insertions(+), 52 deletions(-) diff --git a/skills/claude-api/SKILL.md b/skills/claude-api/SKILL.md index 6441d6c4d..dfd4e73bf 100644 --- a/skills/claude-api/SKILL.md +++ b/skills/claude-api/SKILL.md @@ -464,7 +464,7 @@ Server-side tools run on Anthropic's infrastructure — no client-side execution ## Reading Guide -After detecting the language, read the relevant files based on what the user needs. +After detecting the language, read the relevant files based on what the user needs. Every `{lang}/…`, `shared/…`, and `curl/…` path cited in this document is relative to this skill's base directory, and none of those files' content is included above — Read each one on demand before relying on what it covers. **All SDK languages use the same multi-file layout** — directory `{lang}/claude-api/` containing `README.md` (install, client init, basic request, thinking, caching, stop details, misc), `tool-use.md` (tool definitions, agentic loop, Anthropic-defined tools, structured outputs), `streaming.md`, `batches.md`, `files-api.md`. Not every language has every file (e.g., Ruby has no `batches.md`); if a file is absent, that feature's example is not yet documented for that language — fall back to the cURL shape or WebFetch the SDK repo from `shared/live-sources.md`. **cURL** → `curl/examples.md`. diff --git a/skills/claude-api/shared/managed-agents-multiagent.md b/skills/claude-api/shared/managed-agents-multiagent.md index b4d322918..7d2723134 100644 --- a/skills/claude-api/shared/managed-agents-multiagent.md +++ b/skills/claude-api/shared/managed-agents-multiagent.md @@ -196,7 +196,7 @@ agent = client.beta.agents.create( **Rules:** - **At most one advisor entry per roster.** The entry occupies the reserved roster name `anthropic.advisor` — a roster that also lists a member literally named `anthropic.advisor` is a 400. In responses, the advisor entry is echoed **last** in the roster regardless of submitted position. -- **Pairing is validated at agent save:** the advisor model must meet a minimum capability bar, and the agent's own model must not be more capable than its advisor (equals can pair). Invalid pairing → 400. The valid pairs mirror the Messages advisor tool's executor↔advisor table (`shared/tool-use-concepts.md`) — except Claude Fable 5, which is temporarily unavailable as a Managed Agents advisor; use claude-opus-5 instead. Claude Mythos 5 advisors are unaffected — the unavailability is specific to claude-fable-5, despite the two models' shared capabilities. +- **Pairing is validated at agent save:** the advisor model must meet a minimum capability bar, and the agent's own model must not be more capable than its advisor (equals can pair). Invalid pairing → 400. The valid pairs mirror the Messages advisor tool's executor↔advisor table (`shared/tool-use-concepts.md`). - **Only the primary thread consults it.** The advisor is not a roster agent: invisible to the coordinator's `list_agents` tool, unreachable via `send_to_agent`, and roster agents cannot consult it. **How consultations work.** Each consultation runs as a platform-spawned thread named `anthropic.advisor` that terminates itself when done; the advice is delivered to the primary thread as an `agent.thread_message_received` event. Typical event order (the reserved name rides `agent_name` on lifecycle events and `from_agent_name` on the delivery): diff --git a/skills/claude-api/shared/model-migration.md b/skills/claude-api/shared/model-migration.md index 66887f1e9..95b140865 100644 --- a/skills/claude-api/shared/model-migration.md +++ b/skills/claude-api/shared/model-migration.md @@ -94,7 +94,6 @@ Code examples in this guide are Python. **The same fields exist in every officia > **Verify type and method names against the SDK source before writing them into customer code.** WebFetch the relevant repository from the SDK source-code table in `shared/live-sources.md` (one row per SDK) and confirm the exact symbol — particularly for typed SDKs (Go, Java, C#) where union/builder names can differ from the JSON shape. Do not guess type names that aren't in the table below or in `/claude-api/README.md`. - ### `thinking` — `budget_tokens` → adaptive diff --git a/skills/claude-api/shared/platform-availability.md b/skills/claude-api/shared/platform-availability.md index 4f50a4419..3924524cd 100644 --- a/skills/claude-api/shared/platform-availability.md +++ b/skills/claude-api/shared/platform-availability.md @@ -46,52 +46,3 @@ Columns: **1P** = first-party Claude API, **P-AWS** = Claude Platform on AWS (An |   Fast mode | β | ❌ | ❌ | ❌ | ❌ | Research preview, beta `fast-mode-2026-02-01`, first-party API only | |   Cache diagnostics | β | ❌ | ❌ | ❌ | ❌ | First-party API only | |   Task budgets | β | β | ❌ | ❌ | ❌ | Beta header `task-budgets-2026-03-13`; 3P availability not documented — assume unsupported | - -