skills.rest
voidful
voidfulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

anthropic-sdk-upgrader

Upgrades Anthropic SDK packages and migrates breaking API changes in TypeScript codebases.

1|Updated Apr 8, 2026
Search Tags:#typescript#npm#dependency management#migration#breaking changes#upgrade#anthropic sdk
One-click install
npx skills add https://github.com/voidful/Aixlarity --skill anthropic-sdk-upgrader-voidful
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: anthropic-sdk-upgrader
Source: https://github.com/voidful/Aixlarity/tree/main/aixlarity-ide/extensions/copilot/.agents/skills/anthropic-sdk-upgrader
Command: npx skills add https://github.com/voidful/Aixlarity --skill anthropic-sdk-upgrader-voidful

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @anthropic-ai/sdk, @anthropic-ai/claude-agent-sdk.

What problem does it solve? Upgrading @anthropic-ai/sdk or @anthropic-ai/claude-agent-sdk often introduces breaking changes, renamed types, and changed signatures that cause compilation errors and subtle runtime issues. This Skill provides a structured, repeatable process for performing these upgrades safely. ## Core Features & Use Cases - Changelog Consolidation: Summarizes release notes between versions, grouped by features, bug fixes, and breaking changes with migration steps. - API Surface Diffing: Snapshots and diffs TypeScript .d.ts type definitions before and after npm install to detect new exports, changed signatures, removals, and deprecations. - Verification Workflow: Fixes compilation errors, runs Claude agent unit tests, updates documentation, and produces a detailed commit message. - Use Case: When bumping @anthropic-ai/claude-agent-sdk from 0.2.5 to 0.2.31, the Skill identifies that KillShellInput was renamed to TaskStopInput and updates the type mapping in claudeTools.ts accordingly. ## Quick Start Upgrade the Anthropic SDK packages to their latest versions and migrate any breaking changes in the codebase.

Frequently Asked Questions about anthropic-sdk-upgrader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade the Anthropic SDK to the latest version?▼

Run npm install @anthropic-ai/claude-agent-sdk @anthropic-ai/sdk after reviewing release notes on GitHub. Then diff the type definitions, fix compilation errors with npm run compile, and run the Claude agent unit tests to verify nothing broke.

How to detect breaking changes when upgrading Anthropic SDK packages?▼

Snapshot the .d.ts type definition files before running npm install, then diff them against the new versions afterward. Categorize findings into new exports, changed signatures, removed or renamed items, and deprecations, flagging removals as critical.

What is the difference between @anthropic-ai/sdk and @anthropic-ai/claude-agent-sdk?▼

@anthropic-ai/sdk is the base Anthropic API SDK providing types, the API client, and message structures. @anthropic-ai/claude-agent-sdk is the Claude Agent SDK providing the agent runtime, tools, hooks, sessions, and message streaming built on top of it.

Why do I get type errors after upgrading the Anthropic SDK?▼

Type errors usually come from renamed types, removed exports, or changed function signatures between versions. Check the diff of type definitions, update imports in files like claudeTools.ts, and verify generic type parameters still match.

How do I verify an Anthropic SDK upgrade did not break anything?▼

Run npm run compile to catch type errors, then execute the Claude agent unit tests with npm run test:unit filtered to the agents/claude path. Fix any failing session, hook, or tool tests before committing.

Related Skills

Explore More Software Engineering Skills→
oalansilvaoalansilva

dependency-upgrade-plan

Identify version gaps and breaking changes between current and target dependencies.

Community
Intermediate
glowingkittyglowingkitty
43

deploy

Automate linting, previewing, committing, and pushing tracked code changes via OpenMates session tooling.

Community
Intermediate
eygrabereygraber
1

check

Run formatting, detekt, lint, and unit tests on Android and Kotlin projects.

Community
Intermediate
robinebersrobinebers
46

upgrade-stripe

Automate Stripe API version and SDK upgrades with migration guidance.

Community
Intermediate