How do I install the Cosmosdb Sdk skill?

Run npx skillmds@latest add atc-net/cosmosdb-sdk in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cosmosdb Sdk safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cosmosdb Sdk?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cosmosdb Sdk free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cosmosdb Sdk?

atc-net (@atc-net) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cosmosdb Sdk by atc-net — Agent Skill

Name: Cosmosdb Sdk
Rating: 4.5 (4 reviews)
Author: atc-net

Cosmosdb Sdk

Azure Cosmos DB SDK best practices for .NET, Java, Python, Spring Boot, and LangChain: singleton client, async APIs, connection modes, retry handling, diagnostics, serialization, emulator configuration, ETags, and framework-specific patterns. USE FOR: CosmosClient singleton, async API, Direct vs Gateway mode, retry 429, preferred regions, excluded regions, availability strategy, circuit breaker, SDK diagnostics, serialization enums, emulator SSL, ETag concurrency, conditional create, patch increment, continuation token, content response, Spring Data Cosmos, Spring Boot versions, Newtonsoft dependency, namespace collision, Python async deps, local dev config, LangChain Cosmos DB saver, LangGraph checkpointer, MCP persistent session, tool content format, tool filtering, LangChain JS vectorstore, chat history, semantic cache. DO NOT USE FOR: data modeling (use cosmosdb-data-modeling), queries (use cosmosdb-query-optimization), partition keys (use cosmosdb-partition-key).

atc-net Updated Aug 19, 2026 3 repo stars

File contents

Azure Cosmos DB SDK Best Practices

SDK usage patterns and framework-specific guidance for Azure Cosmos DB across .NET, Java, Python, Spring Boot, and LangChain.

When to Apply

Reference these guidelines when:

Configuring CosmosClient instances
Choosing connection modes (Direct vs Gateway)
Handling retries and throttling
Setting up the Cosmos DB Emulator
Using ETags for optimistic concurrency
Integrating with Spring Boot or LangChain
Configuring availability and resilience features

Rules

sdk-singleton-client - Reuse CosmosClient as singleton
sdk-async-api - Use async APIs for throughput
sdk-retry-429 - Handle 429s with retry-after
sdk-connection-mode - Use Direct mode for production
sdk-preferred-regions - Configure preferred regions
sdk-excluded-regions - Exclude regions experiencing issues
sdk-availability-strategy - Configure availability strategy
sdk-circuit-breaker - Use circuit breaker for fault tolerance
sdk-diagnostics - Log diagnostics for troubleshooting
sdk-serialization-enums - Serialize enums as strings
sdk-emulator-ssl - Configure SSL for Cosmos DB Emulator
sdk-etag-concurrency - Use ETags for optimistic concurrency
sdk-conditional-create-etag - Reject duplicates atomically
sdk-request-options-per-call - Never reuse request options
sdk-patch-counter-increment - Use patch incr for atomic counters
sdk-continuation-token-null-guard - Guard empty continuation tokens
sdk-java-content-response - Enable content response on writes (Java)
sdk-java-cosmos-config - Configure Cosmos DB in Spring Boot
sdk-java-spring-boot-versions - Match Java to Spring Boot versions
sdk-local-dev-config - Configure local development
sdk-dotnet-cosmos-package-id - Use correct NuGet package
sdk-newtonsoft-dependency - Reference Newtonsoft.Json explicitly
sdk-python-async-deps - Include aiohttp for Python async
sdk-go-partition-key-metadata - Use current Go SDK with explicit partition-key metadata
sdk-spring-data-annotations - Annotate entities for Spring Data
sdk-spring-data-repository - Use CosmosRepository correctly
sdk-dotnet-namespace-collision - Avoid namespace collisions
sdk-langchain-cosmosdb-saver - CosmosDBSaver for LangGraph
sdk-langchain-async-checkpointer - Async container init
sdk-langchain-mcp-persistent-session - Persistent MCP sessions
sdk-langchain-mcp-tool-content-format - MCP tool content format
sdk-langgraph-mcp-tool-filtering - Filter MCP tools by prefix
sdk-langchain-js-vectorstore-init - LangChain JS vectorstore init
sdk-langchain-js-chat-history - LangChain JS chat history
sdk-langchain-js-embedding-model - LangChain JS embedding model
sdk-langchain-js-filter-injection - LangChain JS filter injection
sdk-langchain-js-fulltext-prerequisites - LangChain JS FTS prerequisites
sdk-langchain-js-managed-identity - LangChain JS managed identity
sdk-langchain-js-search-types - LangChain JS search types
sdk-langchain-js-semantic-cache - LangChain JS semantic cache

---name: cosmosdb-sdkdescription: Azure Cosmos DB SDK best practices for .NET, Java, Python, Spring Boot, and LangChain: singleton client, async APIs, connection modes, retry handling, diagnostics, serialization, emulator configuration, ETags, and framework-specific patterns. USE FOR: CosmosClient singleton, async API, Direct vs Gateway mode, retry 429, preferred regions, excluded regions, availability strategy, circuit breaker, SDK diagnostics, serialization enums, emulator SSL, ETag concurrency, conditional create, patch increment, continuation token, content response, Spring Data Cosmos, Spring Boot versions, Newtonsoft dependency, namespace collision, Python async deps, local dev config, LangChain Cosmos DB saver, LangGraph checkpointer, MCP persistent session, tool content format, tool filtering, LangChain JS vectorstore, chat history, semantic cache. DO NOT USE FOR: data modeling (use cosmosdb-data-modeling), queries (use cosmosdb-query-optimization), partition keys (use cosmosdb-partition-key).---# Azure Cosmos DB SDK Best PracticesSDK usage patterns and framework-specific guidance for Azure Cosmos DB across .NET, Java, Python, Spring Boot, and LangChain.## When to ApplyReference these guidelines when:- Configuring CosmosClient instances- Choosing connection modes (Direct vs Gateway)- Handling retries and throttling- Setting up the Cosmos DB Emulator- Using ETags for optimistic concurrency- Integrating with Spring Boot or LangChain- Configuring availability and resilience features## Rules- [sdk-singleton-client](references/sdk-singleton-client.md) - Reuse CosmosClient as singleton- [sdk-async-api](references/sdk-async-api.md) - Use async APIs for throughput- [sdk-retry-429](references/sdk-retry-429.md) - Handle 429s with retry-after- [sdk-connection-mode](references/sdk-connection-mode.md) - Use Direct mode for production- [sdk-preferred-regions](references/sdk-preferred-regions.md) - Configure preferred regions- [sdk-excluded-regions](references/sdk-excluded-regions.md) - Exclude regions experiencing issues- [sdk-availability-strategy](references/sdk-availability-strategy.md) - Configure availability strategy- [sdk-circuit-breaker](references/sdk-circuit-breaker.md) - Use circuit breaker for fault tolerance- [sdk-diagnostics](references/sdk-diagnostics.md) - Log diagnostics for troubleshooting- [sdk-serialization-enums](references/sdk-serialization-enums.md) - Serialize enums as strings- [sdk-emulator-ssl](references/sdk-emulator-ssl.md) - Configure SSL for Cosmos DB Emulator- [sdk-etag-concurrency](references/sdk-etag-concurrency.md) - Use ETags for optimistic concurrency- [sdk-conditional-create-etag](references/sdk-conditional-create-etag.md) - Reject duplicates atomically- [sdk-request-options-per-call](references/sdk-request-options-per-call.md) - Never reuse request options- [sdk-patch-counter-increment](references/sdk-patch-counter-increment.md) - Use patch incr for atomic counters- [sdk-continuation-token-null-guard](references/sdk-continuation-token-null-guard.md) - Guard empty continuation tokens- [sdk-java-content-response](references/sdk-java-content-response.md) - Enable content response on writes (Java)- [sdk-java-cosmos-config](references/sdk-java-cosmos-config.md) - Configure Cosmos DB in Spring Boot- [sdk-java-spring-boot-versions](references/sdk-java-spring-boot-versions.md) - Match Java to Spring Boot versions- [sdk-local-dev-config](references/sdk-local-dev-config.md) - Configure local development- [sdk-dotnet-cosmos-package-id](references/sdk-dotnet-cosmos-package-id.md) - Use correct NuGet package- [sdk-newtonsoft-dependency](references/sdk-newtonsoft-dependency.md) - Reference Newtonsoft.Json explicitly- [sdk-python-async-deps](references/sdk-python-async-deps.md) - Include aiohttp for Python async- [sdk-go-partition-key-metadata](references/sdk-go-partition-key-metadata.md) - Use current Go SDK with explicit partition-key metadata- [sdk-spring-data-annotations](references/sdk-spring-data-annotations.md) - Annotate entities for Spring Data- [sdk-spring-data-repository](references/sdk-spring-data-repository.md) - Use CosmosRepository correctly- [sdk-dotnet-namespace-collision](references/sdk-dotnet-namespace-collision.md) - Avoid namespace collisions- [sdk-langchain-cosmosdb-saver](references/sdk-langchain-cosmosdb-saver.md) - CosmosDBSaver for LangGraph- [sdk-langchain-async-checkpointer](references/sdk-langchain-async-checkpointer.md) - Async container init- [sdk-langchain-mcp-persistent-session](references/sdk-langchain-mcp-persistent-session.md) - Persistent MCP sessions- [sdk-langchain-mcp-tool-content-format](references/sdk-langchain-mcp-tool-content-format.md) - MCP tool content format- [sdk-langgraph-mcp-tool-filtering](references/sdk-langgraph-mcp-tool-filtering.md) - Filter MCP tools by prefix- [sdk-langchain-js-vectorstore-init](references/sdk-langchain-js-vectorstore-init.md) - LangChain JS vectorstore init- [sdk-langchain-js-chat-history](references/sdk-langchain-js-chat-history.md) - LangChain JS chat history- [sdk-langchain-js-embedding-model](references/sdk-langchain-js-embedding-model.md) - LangChain JS embedding model- [sdk-langchain-js-filter-injection](references/sdk-langchain-js-filter-injection.md) - LangChain JS filter injection- [sdk-langchain-js-fulltext-prerequisites](references/sdk-langchain-js-fulltext-prerequisites.md) - LangChain JS FTS prerequisites- [sdk-langchain-js-managed-identity](references/sdk-langchain-js-managed-identity.md) - LangChain JS managed identity- [sdk-langchain-js-search-types](references/sdk-langchain-js-search-types.md) - LangChain JS search types- [sdk-langchain-js-semantic-cache](references/sdk-langchain-js-semantic-cache.md) - LangChain JS semantic cache

Frequently asked questions