cosmosdb-agent-kit plugin
A skill kit for Azure Cosmos DB: 139 rules in 13 categories on data modeling, partition keys, queries and throughput.
- 62 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill consists of rules and reference text and runs no code of its own.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/cosmosdb-agent-kitDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill consists of rules and reference text and runs no code of its own.
This is third-party code. Review the repository files before installing.
What it does
`cosmosdb-agent-kit` from the Azure Cosmos DB team bundles skills for agents writing code for this database. The main finished skill, `cosmosdb-best-practices`, holds 139 rules in 13 categories with priorities. The most important groups are data modeling and partition key design, then query optimization, SDK practices, design patterns, vector and full-text search, security, indexing, scaling, global distribution and monitoring. The skill is loaded when an agent writes new code for Cosmos DB, designs a data model, picks a partition key, reviews code for performance problems or tunes queries and throughput. Plugin manifests exist for Claude Code, Codex, Cursor, Gemini CLI, Grok Build, Kimi Code and GitHub Copilot.
Who it is for. Azure Cosmos DB developers who hand data modeling, queries and tuning to an agent and do not want code with a poor partition key.
Good fit when
- An agent designs a data model and picks a partition key.
- Code using Cosmos DB is reviewed for performance problems.
- A query spends too many request units and needs optimization.
- Vector or full-text search is being added to the database.
Not a fit when
- Work is on another database: the rules are written only for Cosmos DB.
- A database connection is required: the skill gives rules and configures no access.
- The host loads every skill into context at once and the model has a small window.
Example request
Design a data model for a RAG chat in Cosmos DB, pick a partition key and review the code against the cosmosdb-best-practices rules.Limitations
Only one skill is stable and migration and capacity planning is marked as planned. The authors advise delivering skills on demand: loading the whole set of about 500 KB at once overflows context, especially on models with a window of 128 thousand tokens or less. Evaluation results come from one Python scenario and one agent host, so they are called directional. Testing against a live database needs an Azure Cosmos DB account and the skill does not connect to one itself.
How to disable. Remove the plugin with your agent tools, for example `/plugin uninstall` in Claude Code, or delete the `cosmosdb-best-practices` folder from the skills directory.
FAQ
How do I install it?
Run `apm install AzureCosmosDB/cosmosdb-agent-kit` for all agents at once or `npx skills add AzureCosmosDB/cosmosdb-agent-kit`.
Which skills are ready?
One: `cosmosdb-best-practices` with 139 rules in 13 categories. Migration and capacity planning is still planned.
Why is on-demand delivery advised?
Always-on loading of the whole set of about 500 KB overflowed context and scored zero on small-window models.
Which agents have manifests?
Claude Code, Codex, Cursor, Gemini CLI, Grok Build, Kimi Code and GitHub Copilot.
How do I install it in Gemini CLI?
Run `gemini extensions install https://github.com/AzureCosmosDB/cosmosdb-agent-kit`.
Discussion
No questions or reviews yet.
Related
PluginsA template for data scientists: AGENTS.md, CLAUDE.md and skills for Python, SQL, Polars and model diagnostics.
Neo4j skills for agents: Cypher queries, graph modeling, drivers, import, GraphRAG, GDS and Aura provisioning
Official Elastic skills for Elasticsearch, Kibana, Observability, Security and Elastic Cloud: ES|QL, indices, dashboards, alert triage
Databricks Field Engineering's agent kit: an installer for Databricks skills, an MCP server and a visual Builder App
An MCP server and the dbcode-cli skill: an agent runs SQL through connections already saved in the DBCode editor extension.
Skills for Claude Code and Cursor: search apps, log and trace analytics and OpenSearch deployment in the cloud.
README in short
The README covers where the kit works best, recommended models and evaluation results, the skill list with rule categories and installation for each agent.