azure-cosmos-db
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 NoSQL/Mongo/Cassandra/PostgreSQL APIs, change feed, multi-region HA, vector search, or Kafka/Spark, and other Azure Cosmos DB related development tasks. Not for Azure Table Storage (use azure-table-storage), Azure SQL Database (use azure-sql-database), Azure Database for MySQL (use azure-database-mysql), Azure Database for PostgreSQL (use azu
npx skills add MicrosoftDocs/Agent-Skills --skill azure-cosmos-db --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Guides the agent to provide expert knowledge on Azure Cosmos DB development, including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It is intended for tasks involving Cosmos DB NoSQL/Mongo/Cassandra/PostgreSQL APIs, change feed, multi-region HA, vector search, Kafka/Spark, and related development work. It explicitly notes not to use when the task is for Azure Table Storage, Azure SQL Database, Azure Database for MySQL, or Azure Database for PostgreSQL.
How it works
- Use network access to fetch remote documentation via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage as needed.
- Provide guidance by category, using the Category Index to locate relevant sections. For categories with line ranges, read the file with the specified lines; for linked categories (e.g., integrations.md, deployment.md), read the linked reference file.
- If the metadata timestamp is older than 3 months, suggest pulling the latest version. If mcp_microsoftdocs tools are unavailable, suggest installing them via the provided installation guide.
- Access specific troubleshooting, best practices, architecture, and deployment content through the category sections listed (e.g., Troubleshooting, Best Practices, Deployment, etc.).
When to use it
Use when working on Cosmos DB development tasks across APIs, including change feed, multi-region HA, vector search, and Kafka/Spark integrations. Not applicable for non-Cosmos DB storage or databases as noted in the description.
What it can touch
- Tools: claude-code, copilot, codex (as declared in the skill).
- Documentation fetch via: mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage.
- Read and reference: security.md, integrations.md, deployment.md, and other category content as indicated by the Category Index.
Caveats
Requires network access to fetch documentation. If the generated_at metadata is older than 3 months, a prompt to update should be surfaced. License: CC-BY-4.0 per repository metadata.
# Azure Cosmos DB Skill 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. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpag
- How to Use This Skill
- Category Index
- Troubleshooting
- Best Practices
- Decision Making
- Architecture & Design Patterns
- Limits & Quotas
- Security
- Configuration
What does the azure-cosmos-db skill do?
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 NoSQL/Mongo/Cassandra/PostgreSQL APIs, change feed, multi-region HA, vector search, or Kafka/Spark, and other Azure Cosmos DB related development tasks. Not for Azure Table Storage (use azure-table-storage), Azure SQL Database (use azure-sql-database), Azure Database for MySQL (use azure-database-mysql), Azure Database for PostgreSQL (use azu
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-cosmos-db --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From MicrosoftDocs/Agent-Skills, a repository with 682 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.