About

Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/claude-pack/skills/clade-upgrade-migration/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill clade-upgrade-migration. Copyright stays with the author (MIT).

Anthropic Upgrade & Migration

Name: clade-upgrade-migration
Author: jeremylongshore

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

# Check current version
npm list @claude-ai/sdk
pip show anthropic

# Upgrade to latest
npm install @claude-ai/sdk@latest
pip install --upgrade anthropic

# Check changelog for breaking changes
#

Model Migration Checklist

When Anthropic releases new model versions:

Read the model card — check for behavior changes, new capabilities
Update model IDs — find and replace old IDs

# Find all model references in your codebase
grep -r "claude-" --include="*.ts" --include="*.py" --include="*.json" .

Test with new model — run integration tests against both old and new
Compare outputs — spot-check key prompts for quality regression
Update max_tokens — new models may have different limits
Gradual rollout — use env var to control model selection

// Environment-based model selection for safe rollout
const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-20250514';

const message = await client.messages.create({
  model: MODEL,
  max_tokens: 1024,
  messages,
});

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 max_tokens 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 CLAUDE_MODEL 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.

Step 2: Apply to your codebase

Integrate the patterns that match your requirements. Test each change individually.

Step 3: Verify

Run your test suite to confirm the integration works correctly.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-clade-upgrade-d64f93/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-clade-upgrade-d64f93.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-clade-upgrade-d64f93",
  "kind": "skill",
  "name": "clade-upgrade-migration",
  "description": "Upgrade Anthropic SDK versions and migrate between Claude model generations. Use when working with upgrade-migration patterns. Trigger with \"upgrade anthropic sdk\", \"migrate claude model\", \"anthropic breaking changes\", \"new claude model\".",
  "publisher": "jeremylongshore",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "saas",
      "anthropic",
      "claude",
      "migration",
      "upgrade",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Upgrade Anthropic SDK versions and migrate between Claude model generations. Use when working with upgrade-migration patterns. Trigger with \"upgrade anthropic sdk\", \"migrate claude model\", \"anthropic breaking changes\", \"new claude model\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "plugins/saas-packs/claude-pack/skills/clade-upgrade-migration/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/claude-pack/skills/clade-upgrade-migration/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/claude-pack/skills/clade-upgrade-migration/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(pip:*),",
      "Grep"
    ],
    "license": "MIT"
  },
  "instructions": "# Anthropic Upgrade & Migration\n\n## Overview\n\nUpgrade 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.\n\n## SDK Upgrade\n\n```bash\n# Check current version\nnpm list @claude-ai/sdk\npip show anthropic\n\n# Upgrade to latest\nnpm install @claude-ai/sdk@latest\npip install --upgrade anthropic\n\n# Check changelog for breaking changes\n#\n```\n\n## Model Migration Checklist\n\nWhen Anthropic releases new model versions:\n\n1. **Read ",
  "cost": {
    "context_tokens": 745
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-clade-upgrade-d64f93/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.