Agent skill · software engineering · jeremylongshore
anth-upgrade-migration
Upgrade Anthropic SDK versions and migrate between Claude API versions.
Why this skill is useful
Adds executable scripts for upgrading and migrating the Anthropic SDK that aren't in public docs.
What it needs
Requires npm, pip installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Anthropic Upgrade & Migration Overview Guide for upgrading the Anthropic SDK and migrating between API versions. The SDK follows semver — major versions may have breaking changes. Check Current Versions Upgrade Path Step 1: Create Upgrade Branch Step 2: Upgrade SDK Step 3: Review Breaking Changes Key breaking changes by version: Python SDK 0.20+ (anthropic-version: 2023-06-01) Python SDK 0.30+ (streaming changes) TypeScript SDK 0.20+ (import path change) Step 4: Update API Version Header Step 5: Run Tests and Verify Migration: Text Completions to Messages Text Completions Messages API ----------------- -------------- client.completions.create() client.messages.create() prompt (string) messages (array) maxtokenstosample maxtokens model: "claude-2" model: "claude-sonnet-4-20250514" \n\nHuman:...\n\nAssistant: [{role: "user"}, {role: "assistant"}] response.completion response.content[0].text Rollback Prerequisites Record the current SDK version, lockfile digest, API version header, model identifiers, supported runtime versions, and a tested rollback revision. Obtain release notes from the official SDK/API sources and an approved sandbox workspace with synthetic prompts; production credentials must not be used for migration tests. Define compatibility, latency, cost, and response-shape acceptance thresholds and identify the owner who approves promotion. Instructions 1. Create a migration branch and lock the current dependency graph. Compare the target SDK and API behavior against official release notes; do not infer compatibility from a package version alone. 2. Update the SDK and request shapes in a sandbox, preserving explicit model IDs, maxtokens, authentication through the secret manager, and least-privileged workspace access. 3. Run unit, contract, streaming, tool-use, error, and token-count tests using synthetic fixtures. Compare redacted response-shape and usage receipts with the baseline; never log prompt or response content. 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/anth-upgrade-migration