microsoftdocs/agent-skills/azure-documentdb

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Expert knowledge for Azure DocumentDB development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using DocumentDB vector search, MongoDB-compatible APIs, change streams, cross-region replication, or Data API, and other Azure DocumentDB related development tasks. Not for Azure Cosmos DB (use azure-cosmos-db), Azure Table Storage (use azure-table-storage), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance).

Install

npx vskill@latest install microsoftdocs/agent-skills/azure-documentdb

SKILL.md

Azure DocumentDB Skill

This skill provides expert guidance for Azure DocumentDB. 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

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_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL37-L46Diagnosing and fixing DocumentDB issues: query performance, CMK encryption, replication, and common connectivity/network errors including migration-related problems.
Best PracticesL47-L57Best practices for DocumentDB indexing and queries, safe index changes, and configuring cross-region replication and high availability for resilient, performant data access.
Decision MakingL58-L73Guides for choosing DocumentDB vs MongoDB/Atlas, planning MongoDB migrations, selecting connectivity and cross-region failover, and picking optimal vector index/search algorithms in .NET, Go, TS, and Python
Architecture & Design PatternsL74-L85Patterns for scaling, HA/DR, sharding, multi‑cloud setups, and building Go/TypeScript AI agents (including autonomous travel) on Azure DocumentDB.
Limits & QuotasL86-L99Limits, quotas, and configuration constraints for DocumentDB: compute/storage tiers, free tier caps, SSD performance, indexing/text index limits, document/batch sizes, diagnostics, and feature availability.
SecurityL100-L111Securing DocumentDB clusters: encryption at rest and with customer keys, firewall and public access controls, Private Link, Entra ID RBAC, native users/privileges, and security best practices.
ConfigurationL112-L132Configuring DocumentDB features: search (BM25, vector, fuzzy, phrase, geo), MongoDB compatibility, change streams, replication/scale, transactions, Data API, alerts, and monitoring.
Integrations & Coding PatternsL133-L155Patterns and code samples for integrating Azure DocumentDB with languages, drivers, RAG tools, and vector search, plus migrations (Mongo/Cassandra) and app scenarios like MERN and AI ads.
DeploymentL156-L162Guides for deploying and managing DocumentDB clusters: local dev to Azure, backup/restore, version upgrades, and IaC deployment with Bicep and Terraform.
Troubleshooting
TopicURL
Troubleshoot common Azure DocumentDB issueshttps://learn.microsoft.com/en-us/azure/documentdb/faq
Troubleshoot CMK encryption issues in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-database-encryption-troubleshoot
Diagnose query performance using explain() in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-read-explain-output
Troubleshoot common Azure DocumentDB errors and connectivityhttps://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-common-issues
Troubleshoot network connectivity for DocumentDB migrationshttps://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-connectivity
Troubleshoot Azure DocumentDB replication issueshttps://learn.microsoft.com/en-us/azure/documentdb/troubleshoot-replication
Best Practices
TopicURL
Use background indexing safely in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/background-indexing
Apply cross-region replication best practices in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/cross-region-replication
Implement HA and replication best practices in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/high-availability-replication-best-practices
Apply indexing best practices for Azure DocumentDB collectionshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-create-indexes
Explore practical indexing scenarios in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-index
Safely migrate from non-ordered to ordered indexes in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-migrate-ordered-indexes
Optimize Azure DocumentDB queries with Index Advisorhttps://learn.microsoft.com/en-us/azure/documentdb/index-advisor
Decision Making
TopicURL
Choose Azure first-party services for MongoDB workloadshttps://learn.microsoft.com/en-us/azure/documentdb/azure-mongo-first-party
Decide between Azure DocumentDB and MongoDB Atlashttps://learn.microsoft.com/en-us/azure/documentdb/compare-mongodb-atlas
Choose cross-region failover modes in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/failover-modes
Assess MongoDB readiness and plan migration to DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-assess-plan-migration-readiness
Evaluate MongoDB compatibility in managed serviceshttps://learn.microsoft.com/en-us/azure/documentdb/managed-service-compatibility
Plan and choose MongoDB to Azure DocumentDB migration optionshttps://learn.microsoft.com/en-us/azure/documentdb/migration-options
Select connectivity scenarios for DocumentDB migrationshttps://learn.microsoft.com/en-us/azure/documentdb/migration-scenarios
Evaluate vector search algorithms with .NEThttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-dotnet-select-algorithm
Compare vector index options in Go on DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-go-select-algorithm
Choose optimal vector index algorithm in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-java-select-algorithm
Choose vector index algorithms using TypeScripthttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-nodejs-select-algorithm
Select optimal vector index and similarity in Pythonhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-python-select-algorithm
Architecture & Design Patterns
TopicURL
Apply autoscale behavior for Azure DocumentDB workloadshttps://learn.microsoft.com/en-us/azure/documentdb/autoscale
Understand HA and DR internals for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/availability-disaster-recovery-under-hood
Plan high availability for Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/high-availability
Design multi-cloud architectures with Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/multi-cloud
Design sharding strategy for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/partitioning
Implement Go-based AI agents with DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-go
Build TypeScript AI agents with DocumentDB vector searchhttps://learn.microsoft.com/en-us/azure/documentdb/quickstart-agent-nodejs
Design an autonomous travel agent with DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/tutorial-ai-agent
Limits & Quotas
TopicURL
Use supported compute and storage configurations in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compute-storage
Use supported compute and storage configurations in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/compute-storage
Understand Azure DocumentDB Free Tier limits and featureshttps://learn.microsoft.com/en-us/azure/documentdb/free-tier
Configure Premium SSD v2 performance for DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/high-performance-storage
Configure text indexes and understand their limits in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-create-text-index
Enable diagnostic logs for Azure DocumentDB with tier constraintshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-monitor-diagnostics-logs
Understand indexing behavior and limits in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/indexing
Reference service limits and quotas for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/limitations
Document size and batch write limits in Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/max-document-size
Track Azure DocumentDB feature releases and previewshttps://learn.microsoft.com/en-us/azure/documentdb/release-notes
Security
TopicURL
Understand encryption at rest for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/database-encryption-at-rest
Configure Azure DocumentDB firewall access ruleshttps://learn.microsoft.com/en-us/azure/documentdb/how-to-configure-firewall
Configure Entra ID RBAC authentication for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-connect-role-based-access-control
Configure customer-managed encryption keys for Azure DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-data-encryption
Secure Azure DocumentDB with Azure Private Linkhttps://learn.microsoft.com/en-us/azure/documentdb/how-to-private-link
Manage public network access to Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/how-to-public-access
Manage secondary native users and privileges in DocumentDBhttps://learn.microsoft.com/en-us/azure/documentdb/secondary-users
Apply security best practices to Azure DocumentDB clustershttps://learn.microsoft.com/en-us/azure/documentdb/security

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
725
Repository forks
117
7-day trend score
33

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/microsoftdocs/agent-skills/azure-documentdb/badge)](https://verified-skill.com/skills/microsoftdocs/agent-skills/azure-documentdb)

Something wrong with this skill or its page? Tell us.