Codepit The toolbox

Cosmos DB best practices built into Claude

Gives Claude 73 Azure Cosmos DB rules for data modeling, partition keys, queries, SDK use and more, plus an expert agent and a code review command. Works right after install, with no setup.

Scan checks all of AzureCosmosDB/cosmosdb-claude-code-plugin on your computer, before anything installs.

Codepit runs on your computer. Open this page there to scan it before installing.

A plug going into a small server

What you get

Ten rule categories, an expert agent you start with /agents cosmosdb-expert, and three commands.

  • Data modeling
  • Partition keys
  • Query optimization
  • SDK patterns
  • Indexing
  • Throughput
  • Global distribution
  • Monitoring
  • Design patterns
  • Vector search

Try saying

>/azure-cosmos-db-assistant:cosmos-review

Claude reviews your code against the rules, critical issues first, and gives the rule, severity, the problem and a corrected example for each finding.

Worth knowing

Optional: to work with a live Cosmos DB account, you deploy Microsoft's separate MCP Toolkit to Azure and connect it with an Entra token. That token expires after about an hour and needs refreshing.

/azure-cosmos-db-assistant:generate-skills downloads the latest rule files from the cosmosdb-agent-kit repo on GitHub and overwrites the plugin's local copies.

Comes with three commands

Plus the cosmosdb-best-practices skill and the cosmosdb-expert agent.

  • cosmos-review
  • cosmos-setup
  • generate-skills
Read the author's README README.md