Migrates from the deprecated Microsoft.Azure.DocumentDB SDK (V2) to the modern Microsoft.Azure.Cosmos SDK (V3) for Azure Cosmos DB. Use ONLY when Microsoft.Azure.DocumentDB has been flagged as deprecated or obsolete and must be replaced — not for version-bump scenarios where the V2 SDK is still supported.
Install
npx skills add microsoft/upgrade-agent-plugins --skill migrating-documentdb-to-cosmosnpx skills add microsoft/upgrade-agent-plugins --skill migrating-documentdb-to-cosmos -a claude-code -gnpx skills add microsoft/upgrade-agent-plugins --skill migrating-documentdb-to-cosmos -a codex -ggemini skills install https://github.com/microsoft/upgrade-agent-plugins.git --path plugins/upgrade-agent/upgrade/dotnet/skills/lazy/libraries/migrating-documentdb-to-cosmosgh skill install microsoft/upgrade-agent-plugins migrating-documentdb-to-cosmosgit clone --depth 1 https://github.com/microsoft/upgrade-agent-plugins /tmp/microsoft__upgrade-agent-plugins
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/microsoft__upgrade-agent-plugins/plugins/upgrade-agent/upgrade/dotnet/skills/lazy/libraries/migrating-documentdb-to-cosmos ~/.claude/skills/migrating-documentdb-to-cosmos # Claude Code
cp -R /tmp/microsoft__upgrade-agent-plugins/plugins/upgrade-agent/upgrade/dotnet/skills/lazy/libraries/migrating-documentdb-to-cosmos ~/.agents/skills/migrating-documentdb-to-cosmos # Codex, Cursor, Gemini CLI, Copilot, OpenCode