Syncs the claude-api skill with the current upstream source.
## Managed Agents — five new features
- `effort` on the agent's `model` object (a level string or `{"type": "<level>"}`).
It is agent-configuration only: setting it in a per-session `model` override is
silently ignored.
- Optional `version` on agent update, for optimistic concurrency. Omit it for
last-write-wins.
- `initial_events` on session create, collapsing create plus first send into one
call. Validation is all-or-nothing and only `user.message` and
`user.define_outcome` are accepted.
- Environment and memory-store webhooks: four `environment.*` events and three
`memory_store.*` events.
- Event deltas on per-thread streams. Previews are thread-scoped, so a child
thread's previews never reach the session-level stream.
## Corrections to behavior the skill already documented
- Tool output offload triggers at 100,000 characters (~25k tokens), not 100K
tokens, and covers built-in tools rather than MCP alone.
- `system.message` works on four models, checks only the primary model, appends
system context instead of replacing the prompt, and is accepted during a
`requires_action` idle when it trails a tool result in the same request.
- Vault-to-MCP credential matching is normalized (scheme and host lowercased,
default ports and trailing slashes stripped), not byte-exact.
- Multiagent depth greater than 1 is a validation error, not silently ignored.
- Outcome `interrupted` fires even when evaluation never started, and then
carries an empty-string `outcome_evaluation_start_id`.
- Deployment jitter is 15% of the run interval, floor 5s, cap 9 minutes.
- Webhooks retry three times with jittered 5-120s backoff, then drop silently.
Auto-disable is duration-based with three named triggers.
- `session.status_terminated` means completion or error.
- `agent.thinking` is a progress signal and carries no thinking content.
- `processed_at` is already populated on first sighting for
`user.define_outcome`, `user.custom_tool_result`, and `user.tool_result`.
- Session creation does not provision the sandbox.
- Skill `version` applies to Anthropic-authored skills too.
- Console-created vault credentials are header-injection only, and vault
environment-variable substitution skips secrets in URL paths.
- Console trace URLs need the real workspace ID when the API key is not in the
Default workspace.
## Elsewhere in the skill
- Note partner pricing under the first-party price table: Microsoft Foundry
bills at standard API rates, while Amazon Bedrock and Vertex AI are
partner-operated with separate pricing.
- Correct the tool-runner human-in-the-loop guidance, which previously pointed
readers at the manual loop for approval gates the runner's per-turn hooks
already cover.
- Repoint links away from the retired documentation hosts.
- Dedupe eagerly loaded SKILL.md content that the per-section files already
cover.
- Add Managed Agents scheduled deployments: new
shared/managed-agents-scheduled-deployments.md (cron schedules, deployment
runs, pause/auto-pause), Deployments and Deployment Runs API reference,
beta-header coverage, and SKILL.md routing
- Vault environment_variable credentials: secrets substituted at egress with
networking allowlists; secrets guidance in tools, client-patterns, and
onboarding docs rewritten around them; self-hosted sandbox caveats noted
- Add system.message event for mid-session system prompt updates (Opus 4.8
only) to the events guide and API reference
- Add Claude Fable 5 and Claude Mythos 5 to the model tables with pricing,
context window, and model-selection guidance
- Document Fable-specific API behavior: always-on adaptive thinking (explicit
disabled returns 400), protected-thinking display and replay rules, new
tokenizer (~30% more tokens), refusal stop reason with server-side fallbacks
and SDK fallback middleware, 30-day data-retention requirement
- Add the full Migrating to Claude Fable 5 guide section and checklist,
including the Mythos Preview migration path
- Refresh skill trigger description, effort/compaction/task-budget notes,
caching minimums, structured-output and dynamic-filtering support tables
The model field on agent create accepts {id, speed}, not
{type: "model_config", id, speed}. Aligns with the shape documented
elsewhere in managed-agents-core.md and the request body table.
Add shared/managed-agents-memory.md covering the Memory Stores public
beta under managed-agents-2026-04-01: object model (memstore_/mem_/
memver_), create + seed, attach via resources[] at session-create time,
FUSE mount at /mnt/memory/<store>/, host-side CRUD with create-by-path
vs update-by-id, content_sha256 preconditions, and versions/redact.
Wire it through all cross-references: SKILL.md beta-headers namespace
and reading guide; api-reference SDK method rows, delete/archive quirks
bullet, AddResource note, and three new endpoint sections; core.md
architecture diagram and resources[] enumerations; environments.md
Resources intro; overview.md beta-headers table, Reading Guide row, and
archive-is-permanent bullet.
* Update claude-api skill with Managed Agents guidance
* Replace OPUS_ID placeholder with concrete model string in claude-api skill
* Replace remaining model placeholders with concrete model names and IDs
Documentation skill for building applications with the Claude API
and Agent SDK. Covers Python, TypeScript, Java, Go, Ruby, C#, PHP,
and cURL with language-specific guides for:
- Messages API basics, streaming, and error handling
- Tool use (tool runner and manual agentic loop)
- Structured outputs and adaptive thinking
- Batches and Files APIs
- Agent SDK patterns (Python/TypeScript)
- Model catalog and selection guidance
Lance Martin