⚡

# Azure Cosmos DB Agent Kit

Teaching AI coding agents Cosmos DB best practices — every generated line is production-ready
$ npx skills add AzureCosmosDB/cosmosdb-agent-kit
Open Source · MIT License · agentskills.io
At a Glance
75+
Rules
11
Categories
5
Scenarios
7+
Agents
Rule Categories
1 Data Modeling Critical
2 Partition Key Design Critical
3 Query Optimization High
4 SDK Best Practices High
5 Indexing Strategies Med-High
6 Throughput & Scaling Medium
7 Global Distribution Medium
8 Design Patterns High
9 Vector Search High
10 Full-Text Search High
11 Monitoring Low-Med
How It Works
Install
One command
adds the skill
→
Detect
Agent sees
Cosmos DB task
→
Load
Reads SKILL.md
on demand
→
Apply
Follows rules in
code generation
Self-Improving Feedback Loop
📝
Issue
Create iteration, assign to Copilot
🤖
Generate
Agent writes full app from contract
🧪
Test
CI runs emulator + pytest suite
🔍
Evaluate
Classify failures, find root causes
🔧
Improve
Create new rules, next run scores higher
Test Scenarios
🎮
Gaming Leaderboard
🛒
E-Commerce Orders
💬
AI Chat RAG
📡
IoT Telemetry
🏢
Multi-Tenant SaaS
Compatible Agents
🤖 GitHub Copilot
🧠 Claude Code
💎 Gemini CLI
🔮 OpenAI Codex
📝 OpenCode
🏭 Factory
🌐 GitHub.com
➕ Any AgentSkill
Proven Results
7/10
Iter 1
.NET
7/10
Iter 2
Java
9/10
Iter 3
Python
81%
Batch
5 runs

- Rules from iteration 1 applied correctly in iteration 3
- Found and fixed a bug in the skill's own examples
- Each iteration surfaces new gaps → new rules
- Score improves: 7 → 7 → 9/10 across languages

Get Started
Developers
Install & ask your agent naturally about Cosmos DB tasks
Teams
Fork, create custom scenarios, measure agent quality
Contributors
Add rules using the template, run npm build, submit PR