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 support for template formats (.dotx, .potx, .xltx) across validation
and the helper scripts.
Consolidate the shared office helpers into a single module, replacing the
pack/unpack pipeline with explicit zip/unzip steps. Extraction now rejects
symlink and path-traversal archive entries. Move run merging to a
standalone docx script, since it only ever applied to Word documents.
Fix the redlining validator so it compares against the original even when
a document has no tracked changes, which is when an untracked edit would
otherwise go unreported.
Provision a LibreOffice user profile per invocation so conversions work in
sandboxed environments.
Trim the skill docs to the guidance that earns its place.
- 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.
* Add proper front-matter to SKILL.md for claude-api
Added metadata section with name, description, and license information.
* Apply suggestion from @ericharmeling
---------
Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>
* 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
improve_description.py now calls `claude -p`
as a subprocess instead of the Anthropic SDK, so users no longer need a
separate ANTHROPIC_API_KEY to run the description optimization loop. Same
auth pattern run_eval.py already used for the triggering eval.
Prompts go over stdin (they embed the full SKILL.md body). Strips CLAUDECODE
env var to allow nesting inside a Claude Code session. The over-1024-char
retry is now a fresh single-turn call that inlines the too-long version
rather than a multi-turn followup.
SKILL.md: dropped the stale "extended thinking" reference to match.
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
- Add `compatibility` optional field to SKILL.md frontmatter spec
- Add validation for `compatibility` field in quick_validate.py
- Rename "hyphen-case" to "kebab-case" terminology in init_skill.py
and quick_validate.py
- Update max skill name length from 40 to 64 characters
- Make scripts executable (chmod +x) for accept_changes.py,
comment.py, extract_form_structure.py, add_slide.py, thumbnail.py,
and recalc.py
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
docx: Add commenting and track-changes support. Reorganize OOXML
tooling into a shared office/ module.
pptx: Streamline SKILL.md, add slide-editing and pptxgenjs guides,
bundle html2pptx as a tgz. Reorganize OOXML tooling into a shared
office/ module.
xlsx: Move recalc script into scripts/ and expand it. Add shared
office/ module for OOXML pack/unpack/validate.
pdf: Improve form-filling workflow with new form-structure extraction
script and updated field-info extraction.
Added a note at the top of the README directing users to
agentskills.io for information about the Agent Skills standard.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Reorganize the spec documentation:
- agent-skills-spec.md now serves as an index linking to the guides
- skill-authoring.md covers skill creation and SKILL.md format
- skill-client-integration.md provides guidance for Skill Client implementors
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude <noreply@anthropic.com>
Lance Martin