Azure Cosmos DB Agent Kit
110+
Azure Cosmos DB best-practice rules
Agent skills for real-world Azure Cosmos DB decisions
Build Better AI Coding Agents for Azure Cosmos DB
Azure Cosmos DB Agent Kit packages practical rules, deterministic scenarios, and evaluation workflows so your agents ship faster, spend fewer RUs, and avoid costly modeling mistakes.
5
Core test scenarios for multi-language iterations
2
End-to-end tests and automated tests
Why Teams Use It
High-Impact Rules First
Critical guidance for partition strategy, data modeling, and query tuning is prioritized so agents make correct architectural choices before code generation drifts.
Deterministic Evaluations
Scenario contracts and stable test harnesses make regressions visible quickly and reduce noise across iteration comparisons.
Portable Skill Format
Skills follow the Agent Skills format, making the same guidance reusable across Copilot, Claude Code, and other compatible tools.
Skill Coverage Snapshot
Data Modeling
Partition Design
Query Optimization
SDK Practices
Indexing
Throughput
Global Distribution
Monitoring
The cosmosdb-best-practices skill includes tactical guidance for SQL API usage, vector search setup,
full-text search, consistency, and operational diagnostics.
Testing Workflows
1. Pick a scenario
Use the templates in testing-v2/scenarios/ to define SCENARIO.md and API contracts.
2. Run an iteration
Create iteration folders, generate implementation code, and track per-iteration outcomes.
3. Evaluate + improve
Classify failures, add/adjust rules, rebuild AGENTS docs, and update improvement logs.
Quick Start
npx skills add AzureCosmosDB/cosmosdb-agent-kit
npm install
npm run validate
npm run buildIntegrations & Extensions
Extend Agent Kit capabilities with the MCP Server and plugins for your favorite AI development tools.
MCP Server
Access Azure Cosmos DB agent skills and best practices via the Model Context Protocol (MCP) standard.
Claude Plugin
Use Azure Cosmos DB Agent Kit directly in Claude to get best-practice guidance when building and reviewing code.
Cursor Plugin
Integrate Agent Kit intelligence into Cursor for seamless agent-assisted Azure Cosmos DB development workflows.
More Tools
Available across other AI development platforms and agent frameworks compatible with Agent Skills format.
Help Improve the Agent Kit
Share what is working and where you want deeper guidance. Submitting opens a prefilled GitHub issue in this repository.