cosmosdb-sdk
Azure Cosmos DB SDK and developer tooling for .NET, Java, Python, Go, and Spring Boot: singleton CosmosClient, async APIs, Direct vs Gateway connection mode, retry/429 handling, preferred and excluded regions, availability strategy, circuit breaker, diagnostics, enum serialization, ETag optimistic concurrency, conditional create, patch counter increment, continuation-token guards, per-call request options, content response on write, Spring Data annotations and repositories, NuGet package setup, Python async deps, emulator SSL, and local development / VS Code tooling. USE FOR: reuse CosmosClient as singleton, Direct mode, handle 429 retries, preferred regions, ETag concurrency, atomic patch increment, Spring Boot config, .NET package setup, run the emulator locally, browse data in VS Code. DO NOT USE FOR: modeling/partition/index/query (use cosmosdb-data-and-queries); throughput, global, monitoring, security (use cosmosdb-operations); LangChain/LangGraph/vector/full-text search (use cos
- Installs
- 47
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/azurecosmosdb/cosmosdb-agent-kit --skill cosmosdb-sdk- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads cosmosdb-sdk automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Azure Cosmos DB SDK & Developer Tooling
Best practices for the Azure Cosmos DB SDK across .NET, Java, Python, Go, and Spring Boot, plus local development and emulator tooling.
When to Apply
Reference these guidelines when configuring the Azure Cosmos DB SDK in .NET, Java, Python, Go, or Spring Boot, or setting up local development tooling.
Rules
SDK Best Practices
- sdk-async-api - Use Async APIs for Better Throughput
- sdk-availability-strategy - Configure Threshold-Based Availability Strategy (Hedging)
- sdk-circuit-breaker - Configure Partition-Level Circuit Breaker
- sdk-conditional-create-etag - Use IfNoneMatchETag("*") for conditional creates to prevent duplicates
- sdk-connection-mode - Use Direct Connection Mode for Production
- sdk-continuation-token-null-guard - Guard against empty continuation tokens before calling byPage
- sdk-diagnostics - Log Diagnostics for Troubleshooting
- sdk-dotnet-cosmos-package-id - Use Microsoft.Azure.Cosmos package, not abandoned Azure.Cosmos
- sdk-dotnet-namespace-collision - Avoid Microsoft.Azure.Cosmos namespace collisions with domain models
- sdk-emulator-ssl - Configure SSL and connection mode for Cosmos DB Emulator
- sdk-etag-concurrency - Use ETags for optimistic concurrency on read-modify-write operations
- sdk-excluded-regions - Configure Excluded Regions for Dynamic Failover
- sdk-go-partition-key-metadata - Use current Go Cosmos DB SDK versions and explicit partition-key metadata
- sdk-java-content-response - Unwrap CosmosItemResponse and enable content response in Java SDK
- sdk-java-cosmos-config - Use dependent @Bean methods for Cosmos DB initialization in Spring Boot
- sdk-java-spring-boot-versions - Spring Boot and Java version compatibility for Cosmos DB SDK
- sdk-local-dev-config - Configure local development environment to avoid cloud connection conflicts
- sdk-newtonsoft-dependency - Explicitly reference Newtonsoft.Json package
- sdk-patch-counter-increment - Use the Patch API for atomic counter increments
- sdk-preferred-regions - Configure Preferred Regions for Availability
- sdk-python-async-deps - Include aiohttp When Using Python Async SDK
- sdk-request-options-per-call - Never share a single CosmosItemRequestOptions instance across multiple createItem calls
- sdk-retry-429 - Handle 429 Errors with Retry-After
- sdk-serialization-enums - Use consistent enum serialization between Cosmos SDK and application layer
- sdk-singleton-client - Reuse CosmosClient as Singleton
- sdk-spring-data-annotations - Annotate entities for Spring Data Cosmos with @Container, @PartitionKey, and String IDs
- sdk-spring-data-repository - Use CosmosRepository correctly and handle Iterable return types
Developer Tooling
- tooling-emulator-setup - Use Azure Cosmos DB Emulator for local development and testing
- tooling-vscode-extension - Use Azure Cosmos DB VS Code extension for routine inspection and management
FAQ
What does the cosmosdb-sdk skill do?
Azure Cosmos DB SDK and developer tooling for .NET, Java, Python, Go, and Spring Boot: singleton CosmosClient, async APIs, Direct vs Gateway connection mode, retry/429 handling, preferred and excluded regions, availability strategy, circuit breaker, diagnostics, enum serialization, ETag optimistic concurrency, conditional create, patch counter increment, continuation-token guards, per-call request options, content response on write, Spring Data annotations and repositories, NuGet package setup, Python async deps, emulator SSL, and local development / VS Code tooling. USE FOR: reuse CosmosClient as singleton, Direct mode, handle 429 retries, preferred regions, ETag concurrency, atomic patch increment, Spring Boot config, .NET package setup, run the emulator locally, browse data in VS Code. DO NOT USE FOR: modeling/partition/index/query (use cosmosdb-data-and-queries); throughput, global, monitoring, security (use cosmosdb-operations); LangChain/LangGraph/vector/full-text search (use cos
How do I install cosmosdb-sdk?
Run npx skills add https://github.com/azurecosmosdb/cosmosdb-agent-kit --skill cosmosdb-sdk in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cosmosdb-sdk/ (personal) or .claude/skills/cosmosdb-sdk/ (project).
Which AI agents can use cosmosdb-sdk?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is cosmosdb-sdk safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains cosmosdb-sdk?
It is published by azurecosmosdb in azurecosmosdb/cosmosdb-agent-kit. It has 47 recorded installs.
More from azurecosmosdb/cosmosdb-agent-kit
cosmosdb-best-practices
azurecosmosdb/cosmosdb-agent-kit
Azure Cosmos DB performance optimization and best practices guidelines for NoSQL, partitioning, queries, and SDK usage. Use when writing, reviewing, or refactoring code that interacts with Azure Cosmos DB, designing data models, optimizing queries, or implementing high-performance database operations. USE FOR: Cosmos DB NoSQL, partition key design, RU optimization, point reads, cross-partition queries, SDK singleton, CosmosClient, container modeling, change feed, bulk operations, vector search, full-text search, hierarchical partition keys, global distribution, autoscale throughput, indexing policy, DO NOT USE FOR: PostgreSQL, MySQL, MongoDB (non-Azure), DynamoDB, Cassandra, Azure SQL, Cosmos DB for PostgreSQL (vCore), Cosmos DB for MongoDB vCore, Azure DocumentDB, general SQL databases, Redis, Elasticsearch.
Popular backend & apis skills
find-skills
vercel-labs/skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
entra-app-registration
microsoft/azure-skills
Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.
google-agents-cli-adk-code
google/agents-cli
This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).
embedded-captions
heygen-com/hyperframes
Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.
entra-agent-id
microsoft/azure-skills
Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).
neon
neondatabase/agent-skills
Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.