4 Commits

Author SHA1 Message Date
cj
cdfc3fffc7 claude-api skill: drop the prompt-audit provider-marker note from the subcommand row
Reverts the clause added two commits ago. The prompt-audit row goes
back to "state the assumptions in the report, do not stop to ask" with
no special-casing of non-Anthropic provider markers, matching the
wording that shipped with the prompt-audit subcommand.

No-Verification-Needed: markdown-only skill content, no runtime surface
2026-08-18 12:25:50 +00:00
cj
35d91f51fa claude-api skill: Opus 5 effort bullet reserves xhigh-and-above, not high-and-above
The "start at high, then sweep down" bullet ended with "reserve `high`
and above for tasks where your evals show a quality difference", which
contradicts its own opening. The sibling bullet and the checklist item
both say xhigh/max are the measured-wins tier; align this one.

No-Verification-Needed: markdown-only skill content, no runtime surface
2026-08-17 17:23:14 +00:00
cj
5213442459 claude-api skill: keep prompt-audit non-interactive when provider markers are present
The Before You Start check stops and asks when it sees non-Anthropic
provider markers, but the prompt-audit subcommand is non-interactive.
State in the prompt-audit row that such markers are recorded as an
assumption rather than stopping the audit, and that the audit never
proposes moving those files to the Anthropic SDK.

No-Verification-Needed: markdown-only skill content, no runtime surface
2026-08-17 17:01:02 +00:00
cj
806c24e7ef 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
2026-08-17 16:26:01 +00:00
4 changed files with 3 additions and 53 deletions

View File

@@ -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`.

View File

@@ -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):

View File

@@ -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 `<lang>/claude-api/README.md`.
<!-- The rows below were verified against each SDK's `synced/model-launch-april` branch. -->
### `thinking` — `budget_tokens` → adaptive
@@ -1006,7 +1005,7 @@ The added tool must already be declared in `tools[]` with `"defer_loading": True
**Effort: the full ladder, and where to start.** Claude Opus 5 supports all five levels — `low`, `medium`, `high`, `xhigh`, `max` — with no beta header. The API default is `high`.
- **Start at `high` (the API default), then sweep down.** `low` and `medium` are unusually effective on this model — strong quality at a fraction of the tokens and latency on many workloads — so treat them as the primary cost/latency lever and reserve `high` and above for tasks where your evals show a quality difference. Effort defaults carried over from a prior model are usually not the right setting here; run a fresh sweep.
- **Start at `high` (the API default), then sweep down.** `low` and `medium` are unusually effective on this model — strong quality at a fraction of the tokens and latency on many workloads — so treat them as the primary cost/latency lever and reserve `xhigh` and above for tasks where your evals show a quality difference. Effort defaults carried over from a prior model are usually not the right setting here; run a fresh sweep.
- **`xhigh` and `max` are for measured wins, not a starting point.** `max` is the top tier for the deepest reasoning and worth testing where capability matters more than spend, but it can show diminishing returns and overthink simpler tasks.
At `xhigh` or `max`, **set a large `max_tokens`** so the model has room to think and act across tool calls and subagents. Start at 64K and tune.

View File

@@ -46,52 +46,3 @@ Columns: **1P** = first-party Claude API, **P-AWS** = Claude Platform on AWS (An
| &nbsp;&nbsp;Fast mode | β | ❌ | ❌ | ❌ | ❌ | Research preview, beta `fast-mode-2026-02-01`, first-party API only |
| &nbsp;&nbsp;Cache diagnostics | β | ❌ | ❌ | ❌ | ❌ | First-party API only |
| &nbsp;&nbsp;Task budgets | β | β | ❌ | ❌ | ❌ | Beta header `task-budgets-2026-03-13`; 3P availability not documented — assume unsupported |
<!--
GROUNDING (reviewer-only; stripped at runtime by processSkillMarkdown).
All paths are under docker_eval/resources/cdp-skill/public-docs/.
Primary source: build-with-claude/overview.mdx <PlatformAvailability> props
(claudeApi→1P, claudePlatformAws→P-AWS, bedrock→Bedrock, vertexAi→Vertex,
azureAi→Foundry; *Beta suffix→β; prop absent→❌). Per-row citations:
Context windows ov:44
Adaptive thinking ov:45
Batch / Message Batches ov:46; bed:360; vtx:381; fdy:507
Citations ov:47
inference_geo ov:48
Effort ov:49
Extended thinking ov:50
PDF input ov:51
Search results ov:52
Structured outputs ov:53
Advisor tool ov:63
Code execution ov:64
Web fetch ov:65
Web search ov:66; agents-and-tools/tool-use/web-search-tool.mdx:41
Bash/text-editor/memory ov:72,75,74
Computer use ov:73
Agent Skills ov:83
Fine-grained streaming ov:84
MCP connector ov:85; agents-and-tools/mcp-connector.mdx:36
Programmatic tool call ov:86
Tool search ov:87; agents-and-tools/tool-use/tool-search-tool.mdx:24-30
Compaction ov:95
Context editing ov:96
Automatic caching ov:97
Prompt caching 5m/1h ov:98,99
Token counting ov:100
Files API ov:108; build-with-claude/files.mdx:17
Managed Agents managed-agents/overview.mdx:11,70-72; bed:360; vtx:381
Self-hosted sandboxes build-with-claude/claude-platform-on-aws.mdx:525,547
Mid-convo system msgs build-with-claude/mid-conversation-system-messages.mdx:15
Fast mode build-with-claude/fast-mode.mdx:23
Cache diagnostics build-with-claude/cache-diagnostics.mdx:15,1379
Task budgets build-with-claude/task-budgets.mdx:15
Models API bed:360; vtx:381; fdy:506
ov = build-with-claude/overview.mdx
bed = build-with-claude/claude-in-amazon-bedrock.mdx
vtx = build-with-claude/claude-on-vertex-ai.mdx
fdy = build-with-claude/claude-in-microsoft-foundry.mdx
-->