$ ~/registry/skill/microsoft-extensions-copilot-agents-skills-anthropic-sdk-upgrader

SKILL

anthropic-sdk-upgrader

Name: anthropic-sdk-upgrader
Author: microsoft

Upgrade Anthropic SDKs, migrate versions, and fix dependency or typing issues.

Stars

★ 187,441

Source

GitHub

Updated

2026-07-11

// securityCaution

Prompt only, no code
Open source

Summary

The material indicates a prompt-only skill with an open-source GitHub source, and it declares no required secrets or fixed remote endpoints, so the overall risk is low. While it discusses dependency upgrades and checking release notes, the provided facts do not show direct executable tool permissions, making it closer to a documentation/procedure guidance skill.

CredentialsLow risk

The material explicitly states that no keys or environment variables are required, and it does not request API tokens, account credentials, or other sensitive authentication data.

Network egressLow risk

The system flags it as prompt-only and no remote endpoint is declared; the README only mentions GitHub Releases pages for reference and does not show that the skill itself has data egress capability.

Code executionLow risk

Based on the objective checks, this is a prompt-only skill rather than an executable MCP tool; although the document contains command examples such as npm install, they are instructional content and do not mean the skill can automatically execute local code.

Data accessLow risk

There is no stated ability to read, write, or enumerate local files or system resources; references to package.json, type definitions, and temp directories are operational suggestions, and the material does not prove the skill actually has data access permissions.

Supply chainCaution

The GitHub/open-source source is a positive signal; however, the mapping between the repository information and the skill name is not fully clear, and community adoption is 0 stars with no declared license and unknown maintenance status, leaving some uncertainty around provenance and maintainability.

Recommendations

Use it as upgrade-process guidance rather than automatically executing commands shown in the README.
Before performing real upgrades, manually verify the linked repository, license, and recent maintenance history.
If the platform later grants this skill file or command permissions, apply least privilege first and run it in an isolated environment.

Audited by: gpt-5.4 · 2026-06-17

// install

Copy the install command and let the AI configure it · recommended for beginners

Please install the "anthropic-sdk-upgrader" skill from askskill:
1. Download https://raw.githubusercontent.com/microsoft/vscode/main/extensions/copilot/.agents/skills/anthropic-sdk-upgrader/SKILL.md
2. Save it as ~/.claude/skills/anthropic-sdk-upgrader/SKILL.md
3. Reload skills and tell me it's ready

// download

Download SKILL.mdInstall manifest ↗

// examples

Upgrade to the latest SDK

Prompt

Please upgrade @anthropic-ai/sdk in my project to the latest stable version, check for breaking changes, update the code examples, and list any dependency and type definition changes I need to make.

Expected

An upgrade plan with version change notes, code updates, dependency changes, and key cautions.

Migrate claude-agent-sdk

Prompt

I am using an older version of @anthropic-ai/claude-agent-sdk. Help me migrate to the latest version, explain the API differences, rewrite the initialization and usage examples, and point out possible compatibility issues.

Expected

A migration guide with old-to-new API mapping, rewritten examples, and compatibility risk notes.

Resolve upgrade conflicts

Prompt

After upgrading Anthropic packages, I am seeing dependency conflicts and TypeScript type errors. Analyze the likely causes, give me a step-by-step troubleshooting plan, and provide practical fixes.

Expected

A diagnostic and remediation guide covering conflict sources, troubleshooting steps, and recommended fixes.

// docs

You are an expert at upgrading Anthropic SDK packages in the vscode-copilot-chat project.

Packages

Package	Description
`@anthropic-ai/claude-agent-sdk`	Official Claude Agent SDK - provides the core agent runtime, tools, hooks, sessions, and message streaming
`@anthropic-ai/sdk`	Anthropic API SDK - provides base types, API client, and message structures used by the agent SDK

Upgrade Process

Follow these steps exactly:

1. Check Current Versions and Changelog

Before upgrading, review the current versions in package.json and check the release notes:

Claude Agent SDK Releases: https://github.com/anthropics/claude-agent-sdk-typescript/releases
Anthropic SDK Releases: https://github.com/anthropics/anthropic-sdk-typescript/releases

2. Summarize All Changes

Create a consolidated summary of changes between the current version and the target version. Group changes by category, not by individual version:

Summary Format:

### `@anthropic-ai/package-name` (oldVersion → newVersion)

#### Features
- **Category:** Description of new feature or capability

#### Bug Fixes
- Description of what was fixed

#### Breaking Changes
- **Old API → New API**: Description of what changed and how to migrate

How to Create the Summary:

Read the GitHub Release Notes: Go through each release between your versions
Consolidate by Category: Group all features together, all bug fixes together, etc.
Identify Breaking Changes: Look for:
- Removed or renamed exports
- Changed function signatures
- Modified type definitions
- Deprecated APIs that have been removed
Document Migration Steps: For breaking changes, include the old and new patterns
Check Peer Dependencies: Note if the new version requires different peer dependencies

3. List Important Changes

Categorize changes by impact level:

Critical (Must Address Before Merge):

Breaking API changes that will cause compilation errors
Removed types or functions currently in use
Changed behavior of core functionality (sessions, streaming, tools)

Important (Should Address):

Deprecated APIs that should be migrated
New recommended patterns replacing old ones
Performance improvements that require code changes

Nice to Have (Can Address Later):

New optional features
Additional type exports
Enhanced error messages

4. Update Package Versions

# Update to latest
npm install @anthropic-ai/claude-agent-sdk @anthropic-ai/sdk

5. Detect API Surface Changes

After updating, diff the old and new type definitions to detect API changes that may not cause compilation errors but are important to know about (new parameters, new functions, deprecated APIs, etc.).

Steps:

Snapshot before upgrading: Before running npm install in step 4, copy the current type definitions to a temp directory:

mkdir -p /tmp/anthropic-sdk-old
cp -r node_modules/@anthropic-ai/sdk/*.d.ts node_modules/@anthropic-ai/sdk/resources/*.d.ts /tmp/anthropic-sdk-old/ 2>/dev/null
cp -r node_modules/@anthropic-ai/claude-agent-sdk/*.d.ts /tmp/anthropic-sdk-old/ 2>/dev/null

Important: This snapshot must be taken before step 4's npm install.

Diff the type definitions: After npm install, compare the old and new .d.ts files:

# Diff the Anthropic SDK types
for f in node_modules/@anthropic-ai/sdk/*.d.ts node_modules/@anthropic-ai/sdk/resources/*.d.ts; do
  base=$(basename "$f")
  if [ -f "/tmp/anthropic-sdk-old/$base" ]; then
    diff -u "/tmp/anthropic-sdk-old/$base" "$f"
  else
    echo "+++ NEW FILE: $f"
  fi
done

# Diff the Agent SDK types
for f in node_modules/@anthropic-ai/claude-agent-sdk/*.d.ts; do
  base=$(basename "$f")
  if [ -f "/tmp/anthropic-sdk-old/$base" ]; then
    diff -u "/tmp/anthropic-sdk-old/$base" "$f"
  else

…

View full docs ↗