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.

View on GitHub Install Kit Watch Demo

## 110+

Azure Cosmos DB best-practice rules

## 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 build

## Integrations & 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.

View MCP Toolkit →

### Claude Plugin

Use Azure Cosmos DB Agent Kit directly in Claude to get best-practice guidance when building and reviewing code.

View on Claude Marketplace →

### Cursor Plugin

Integrate Agent Kit intelligence into Cursor for seamless agent-assisted Azure Cosmos DB development workflows.

View on Cursor Marketplace →

### 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.

Your role
How often do you use the kit?
Overall usefulness (1-5) Rule clarity (1-5) Scenario coverage (1-5) Example quality (1-5) What has been most valuable? Where did the agent output still fail you? What should we add next? Optional contact (GitHub handle or email)