Agent skill · software engineering · jeremylongshore

clade-upgrade-migration

Upgrade Anthropic SDK versions and migrate between Claude model generations.

Why this skill is useful

Adds specific commands and migration patterns for upgrading the Anthropic SDK and migrating Claude models that the AI wouldn't reliably generate on its own.

What it needs

Requires npm, pip installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.

What this skill does

Anthropic Upgrade & Migration Overview Upgrade the Anthropic SDK to new versions and migrate between Claude model generations. Covers version checking, changelog review, model ID updates across the codebase, output comparison testing, and gradual rollout via environment variables. SDK Upgrade Model Migration Checklist When Anthropic releases new model versions: 1. Read the model card — check for behavior changes, new capabilities 2. Update model IDs — find and replace old IDs 1. Test with new model — run integration tests against both old and new 2. Compare outputs — spot-check key prompts for quality regression 3. Update maxtokens — new models may have different limits 4. Gradual rollout — use env var to control model selection Common Migration Issues Issue Fix ------- ----- Model ID not found (404) Update to current model ID Different output format Adjust parsing — test with real prompts Higher/lower token usage Re-evaluate maxtokens and cost estimates Deprecated SDK method Check SDK changelog for replacement Output SDK upgraded to latest version Model IDs updated across all files Integration tests passing with new model Output quality verified against previous model Gradual rollout configured via CLAUDEMODEL environment variable Error Handling Error Cause Solution ------- ------- ---------- API Error Check error type and status code See clade-common-errors Examples See SDK Upgrade commands, grep patterns for finding model references, environment-based model selection, and Common Migration Issues table above. Resources SDK Releases (TS) SDK Releases (Python) Model Deprecation Policy Next Steps See clade-known-pitfalls for common mistakes to avoid. Prerequisites Existing Anthropic SDK integration to upgrade Access to the codebase with grep/search capability Test suite for comparing model outputs Instructions Step 1: Review the patterns below Each section contains production-ready code examples. Copy and adapt them to your use case. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills jeremylongshore/clade-upgrade-migration

View the source on GitHub

Browse the @skills marketplace