Best for
- Use when using Cosmos DB APIs (NoSQL/Mongo/Cassandra/PostgreSQL), change feed, vector search, Kafka/Spark, or multi-region HA, and other Azure Cosmos DB related development tasks.
MicrosoftDocs/Agent-Skills/skills/azure-cosmos-db/SKILL.md
Expert knowledge for Azure Cosmos DB development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Cosmos DB APIs (NoSQL/Mongo/Cassandra/PostgreSQL), change feed, vector search, Kafka/Spark, or multi-region HA, and other Azure Cosmos DB related development tasks. Not for Azure Table Storage (use azure-table-storage), Azure SQL Database (use azure-sql-
Decision brief
This skill provides expert guidance for Azure Cosmos DB. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content w…
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill "skills/azure-cosmos-db"Inspect the Agent Skill "azure-cosmos-db" from https://github.com/MicrosoftDocs/Agent-Skills/blob/c579bb4b37e7969ffc8bc071ca0f53048c3bfe41/skills/azure-cosmos-db/SKILL.md at commit c579bb4b37e7969ffc8bc071ca0f53048c3bfe41. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use readfile with the specified lines. For categories with file links (e.g., security.md), use readfile on the linked reference file
Review the “Category Index” section in the pinned source before continuing.
Review the “Troubleshooting” section in the pinned source before continuing.
Review the “Best Practices” section in the pinned source before continuing.
Review the “Decision Making” section in the pinned source before continuing.
Permission review
The documentation includes network, browsing, or remote request actions.
| Write Cosmos DB stored procedures using JavaScript query API | https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-write-javascript-query-api |The documentation includes network, browsing, or remote request actions.
| Use JavaScript query API inside Cosmos DB server-side code | https://learn.microsoft.com/en-us/azure/cosmos-db/javascript-query-api |Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 90/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 717 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
This skill provides expert guidance for Azure Cosmos DB. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L87 | Diagnosing and fixing Cosmos DB issues across APIs and SDKs: connection and timeout errors, RU/latency problems, encryption/CMK and replication issues, and advanced diagnostics/log queries. |
| Best Practices | L88-L141 | Best practices for performance, cost, partitioning, consistency, SDK usage, change feed, disaster recovery, and workload tuning across Cosmos DB APIs (NoSQL, MongoDB, Cassandra, PostgreSQL). |
| Decision Making | L142-L188 | Guides for choosing Cosmos DB deployment, scaling, consistency, pricing, migration, SDK upgrades, and PostgreSQL/Mongo/Cassandra/Table options to match workload, cost, and resiliency needs. |
| Architecture & Design Patterns | L189-L216 | Patterns and reference architectures for AI agents, change feed, analytics, multi-region HA, SaaS/multi-tenant design, microservices, and vector/AI search on Cosmos DB and Cosmos DB for PostgreSQL. |
| Limits & Quotas | L217-L251 | Limits, quotas, and behaviors for Cosmos DB throughput, partitions, backups, serverless, APIs (Core, Cassandra, Gremlin, Table, PostgreSQL), and related performance/retention constraints. |
| Security | L252-L318 | Securing Cosmos DB and related services: identity/RBAC, network isolation (firewall, Private Link, VNet), encryption/CMK, auditing, data masking, TLS, and security best practices per API. |
| Configuration | L319-L441 | Configuring Cosmos DB and its APIs: throughput, indexing, backup/restore, fleets, emulators, monitoring, alerts, SDK tuning, and PostgreSQL/Cassandra/MongoDB-specific settings. |
| Integrations & Coding Patterns | L442-L568 | SDK usage, integrations, and patterns for connecting apps/tools to Cosmos DB (NoSQL, Mongo, Cassandra, PostgreSQL), including change feed, Kafka/Spark, vector search, and bulk/transactional operations. |
| Deployment | L569-L596 | Deploying, migrating, and managing Cosmos DB (NoSQL, Cassandra, MongoDB, PostgreSQL, Table) using Bicep/ARM/Terraform, CI/CD, emulator, AKS apps, and bulk import workflows. |
Frequently asked questions
This skill provides expert guidance for Azure Cosmos DB. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content w…
The source record exposes this install command: npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill "skills/azure-cosmos-db". Inspect the command and pinned source before running it.
Static rules flagged network in the source; the page lists the matching lines and excerpts.
Alternatives
MicrosoftDocs/Agent-Skills
Expert knowledge for Azure Data Factory development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building ADF pipelines with data flows, SHIR/SSIS IR, VNets/private endpoints, CI/CD templates, or SAP CDC, and other Azure Data Factory related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure Databricks (use azure-da
MicrosoftDocs/Agent-Skills
Expert knowledge for Azure Migrate development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring Azure Migrate projects/appliances, VMware/Hyper-V discovery, SQL/PostgreSQL assessments, AppCAT, or Resource Mover, and other Azure Migrate related development tasks. Not for Azure Database Migration Service (use azure-database-migration), Azure Site
MicrosoftDocs/Agent-Skills
Expert knowledge for Azure Sentinel development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring data connectors, ASIM analytics, KQL/REST integrations, playbooks, or Sentinel deployments, and other Azure Sentinel related development tasks. Not for Azure Defender For Cloud (use azure-defender-for-cloud), Azure Security (use azure-security), Azu
MicrosoftDocs/Agent-Skills
Expert knowledge for Azure SQL Database development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring serverless billing, Hyperscale, geo-replication/DR, Data Sync/sharding, or elastic pools, and other Azure SQL Database related development tasks. Not for Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Ma