A

Azure Cosmos DB Agent Kit

Azure Cosmos DB best-practice skills and MCP tooling for Codex, Claude Code, Cursor, Gemini CLI, Grok Build, Kimi Code, GitHub Copilot, and other Agent Skills-compatible assistants

azure-cosmos-db/azure-cosmosdb · v1.3.0 · Tools & Integrations

Azure Cosmos DBreview
InstallSourceClaim this plugin
76Follow0

Trust Score

76

Security

88

Surfaces

2

What is Azure Cosmos DB Agent Kit?

Azure Cosmos DB Agent Kit is a published tools & integrations plugin for AI coding agents in the codex ecosystem, developed by Azure Cosmos DB and distributed through the HOL AI plugin registry. Azure Cosmos DB best-practice skills and MCP tooling for Codex, Claude Code, Cursor, Gemini CLI, Grok Build, Kimi Code, GitHub Copilot, and other Agent Skills-compatible assistants

Canonical slug
azure-cosmos-db/azure-cosmosdb
Version
v1.3.0 · updated Oct 3, 2026

Trust & Reputation

HOL Trust Score
76

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
88pts
Maintenance
75pts
MCP Posture
100pts
Plugin Security
88pts
Provenance
70pts
Publisher Quality
75pts

Registry Snapshot

Publisher verification
No
Marketplace source
Unknown
Scanner
Broker fallback
Safety label
review
Digest verified
Yes
1 bundled skill — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score
76

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
88pts
Maintenance
75pts
MCP Posture
100pts
Plugin Security
88pts
Provenance
70pts
Publisher Quality
75pts

Provenance

Plugin root
.
Source repo
https://github.com/AzureCosmosDB/cosmosdb-agent-kit
Source commit
110f3e91e8f0…
Publisher verified
No
Owner verified
Not owner verified

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

review
Safety label
88
Security score
0
High findings
Provider
registry-broker-fallback
Grade
B · review
Version
Unknown
cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

Azure Cosmos DB Agent Kit — Frequently asked questions

What is Azure Cosmos DB Agent Kit?
Azure Cosmos DB Agent Kit is an AI plugin in the HOL registry. Azure Cosmos DB best-practice skills and MCP tooling for Codex, Claude Code, Cursor, Gemini CLI, Grok Build, Kimi Code, GitHub Copilot, and other Agent Skills-compatible assistants
How do I install Azure Cosmos DB Agent Kit?
Install Azure Cosmos DB Agent Kit in your harness: Codex — codex plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit; Claude Code — /plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit; Cursor — npx skills add AzureCosmosDB/cosmosdb-agent-kit. Full step-by-step guidance is on the HOL plugin page.
How do I install Azure Cosmos DB Agent Kit in Codex?
To install Azure Cosmos DB Agent Kit in Codex, start with codex plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit. The complete step-by-step install guide for Codex is on the HOL plugin page.
How do I install Azure Cosmos DB Agent Kit in Claude Code?
To install Azure Cosmos DB Agent Kit in Claude Code, start with /plugin marketplace add AzureCosmosDB/cosmosdb-agent-kit. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How do I install Azure Cosmos DB Agent Kit in Cursor?
To install Azure Cosmos DB Agent Kit in Cursor, start with npx skills add AzureCosmosDB/cosmosdb-agent-kit. The complete step-by-step install guide for Cursor is on the HOL plugin page.
Is Azure Cosmos DB Agent Kit free?
Pricing for Azure Cosmos DB Agent Kit is published on its HOL plugin page when the maker schedules a launch.
Who publishes Azure Cosmos DB Agent Kit?
Azure Cosmos DB Agent Kit is published by Azure Cosmos DB and listed on HOL.
Is Azure Cosmos DB Agent Kit available now?
Azure Cosmos DB Agent Kit availability is listed on its HOL plugin page.

Install Guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs
  1. 1

    Add the marketplace

    Run this inside a Claude Code session.

    claude code
  2. 2

    Install the plugin

    Use the plugin name and the marketplace name shown by the previous command.

    claude code
  3. 3

    Scripted alternative

    Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.

    shell

Plugin Manifest

{
  "name": "azure-cosmosdb",
  "version": "1.3.0",
  "description": "Official Codex plugin for Azure Cosmos DB (NoSQL). Best practice skills for data modeling, queries, indexing, vector search, security, and more.",
  "author": {
    "name": "Azure Cosmos DB",
    "email": "[email protected]",
    "url": "https://azure.microsoft.com/products/cosmos-db"
  },
  "homepage": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",
  "repository": "https://github.com/AzureCosmosDB/cosmosdb-agent-kit",
  "license": "MIT",
  "keywords": [
    "azure",
    "cosmosdb",
    "cosmos-db",
    "nosql",
    "database",
    "vector-search",
    "agent-skills"
  ],
  "skills": "./",
  "interface": {
    "displayName": "Azure Cosmos DB",
    "developerName": "Azure Cosmos DB",
    "shortDescription": "Official Azure Cosmos DB plugin: skills and best practices for NoSQL workflows on Azure.",
    "longDescription": "The official Azure Cosmos DB plugin bundles a curated set of agent skills covering data modeling, partition key design, query optimization, SDK best practices (singleton client, bulk operations, direct mode), indexing strategies (composite, spatial, exclude unused), vector search (DiskANN, flat, quantized flat), full-text search (BM25, hybrid queries), global distribution (multi-region writes, conflict resolution), security (Entra ID, managed identity, RBAC, network restrictions), throughput and scaling (autoscale, serverless), monitoring and diagnostics, and design patterns (change feed, transactional batch). It gives your agent the knowledge to generate reliable Cosmos DB code and apply best practices end to end.",
    "category": "Databases",
    "capabilities": [
      "Read"
    ],
    "websiteURL": "https://learn.microsoft.com/azure/cosmos-db/",
    "privacyPolicyURL": "https://privacy.microsoft.com/privacystatement",
    "defaultPrompt": [
      "Review my Cosmos DB data model for best practices.",
      "Help me choose a partition key for my orders collection.",
      "Optimize this Cosmos DB query for lower RU consumption.",
      "Set up vector search on my Cosmos DB container.",
      "What security setup do I need for a new Cosmos DB app?"
    ],
    "brandColor": "#0078D4",
    "composerIcon": "./assets/composer-icon.svg",
    "logo": "./assets/logo.svg"
  },
  "mcpServers": "./.registry/mcp.json",
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL
https://github.com/AzureCosmosDB/cosmosdb-agent-kit
Marketplace path
Unknown
Source path
.
Install policy
Unspecified

Skills

1 SKILL.md file ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli

  • cosmosdb-best-practices

    skills/cosmosdb-best-practices/SKILL.md

    |

    Raw SKILL.md

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File Inventory

.claude-plugin/plugin.json

file

786 bytes

91b5dd23479e2d5d…

.codex-plugin/plugin.json

plugin-manifest

2,155 bytes

2a5d614889931930…

.cursor-plugin/plugin.json

file

700 bytes

bc2d8d64f3f6273b…

.github/instructions/code-review.instructions.md

file

3,752 bytes

cd6bfa3816f8a170…

.kimi-plugin/plugin.json

file

2,491 bytes

7f3e7b9f7b4a251f…

.mcp.json

file

132 bytes

70e070f3b1e9d0a5…

.registry/mcp.json

mcp-config

93 bytes

eb55aff817695661…

AGENTS.md

file

3,045 bytes

0e3c93ade6e7c0bb…

assets/composer-icon.svg

asset

2,641 bytes

82a450bd82f634e1…

assets/logo.svg

asset

2,641 bytes

82a450bd82f634e1…

gemini-extension.json

file

328 bytes

e12e14ac3a68babe…

GEMINI.md

file

1,441 bytes

a17c301df362005c…

package-lock.json

file

22,993 bytes

aac66aad04ed5512…

package.json

file

937 bytes

1d121edaebaeaae3…

plugin.json

file

758 bytes

09565f16ba9234d1…

README.md

file

13,470 bytes

a2b96628b3ac7bba…

skills/cosmosdb-best-practices/agents/openai.yaml

skill

310 bytes

79eaa9734ff61a0b…

skills/cosmosdb-best-practices/metadata.json

skill

559 bytes

d0e3b2438d3debf5…

skills/cosmosdb-best-practices/README.md

skill

4,905 bytes

f5d36077f842e8c9…

skills/cosmosdb-best-practices/rules/_sections.md

skill

3,085 bytes

183984553af2fbdf…

skills/cosmosdb-best-practices/rules/_template.md

skill

1,039 bytes

89bb70fdb28677a2…

skills/cosmosdb-best-practices/rules/fts-add-index.md

skill

1,976 bytes

5b8da51c91cc5bdb…

skills/cosmosdb-best-practices/rules/fts-define-policy.md

skill

1,707 bytes

28ccb755c87c11a5…

skills/cosmosdb-best-practices/rules/fts-enable-capability.md

skill

1,636 bytes

0cb9c218349cd931…

skills/cosmosdb-best-practices/rules/fts-hybrid-queries.md

skill

2,327 bytes

6d978c6593efcab5…

skills/cosmosdb-best-practices/rules/fts-keyword-matching.md

skill

2,209 bytes

6d7efbd6e22bc88f…

skills/cosmosdb-best-practices/rules/fts-relevance-ranking.md

skill

1,459 bytes

b4115d2db992fe7f…

skills/cosmosdb-best-practices/rules/global-conflict-resolution.md

skill

4,087 bytes

88870c56433c0148…

skills/cosmosdb-best-practices/rules/global-consistency.md

skill

3,962 bytes

eae1366614959df8…

skills/cosmosdb-best-practices/rules/global-failover.md

skill

3,804 bytes

25d7025b0c2d6358…

skills/cosmosdb-best-practices/rules/global-multi-region-write-antipattern.md

skill

2,646 bytes

7469fce9b562f2c0…

skills/cosmosdb-best-practices/rules/global-multi-region.md

skill

3,313 bytes

0900da572383d41a…

skills/cosmosdb-best-practices/rules/global-read-regions.md

skill

3,994 bytes

b81e71bb507d2a16…

skills/cosmosdb-best-practices/rules/global-zone-redundancy.md

skill

3,576 bytes

bebce105f8fbe345…

skills/cosmosdb-best-practices/rules/index-composite-direction.md

skill

2,892 bytes

6573072cdbe28b2f…

skills/cosmosdb-best-practices/rules/index-composite.md

skill

11,955 bytes

f3c325676933644f…

skills/cosmosdb-best-practices/rules/index-exclude-unused.md

skill

4,046 bytes

fa1abd9c716696f0…

skills/cosmosdb-best-practices/rules/index-lazy-consistent.md

skill

3,363 bytes

77af27ef69622432…

skills/cosmosdb-best-practices/rules/index-path-syntax.md

skill

2,545 bytes

965c6c4fdeca539b…

skills/cosmosdb-best-practices/rules/index-range-vs-hash.md

skill

3,956 bytes

49eaa859ff30fa58…

skills/cosmosdb-best-practices/rules/index-spatial.md

skill

3,193 bytes

a169e6dbda106294…

skills/cosmosdb-best-practices/rules/model-avoid-2mb-limit.md

skill

2,096 bytes

19f20f18e74e37e2…

skills/cosmosdb-best-practices/rules/model-denormalize-reads.md

skill

12,537 bytes

e26ec00e7a21d7df…

skills/cosmosdb-best-practices/rules/model-embed-related.md

skill

2,528 bytes

fd7b77d4884c9926…

skills/cosmosdb-best-practices/rules/model-id-constraints.md

skill

7,581 bytes

9f046514db190e77…

skills/cosmosdb-best-practices/rules/model-json-serialization.md

skill

6,175 bytes

a7799e92f6d1d9a3…

skills/cosmosdb-best-practices/rules/model-nesting-depth.md

skill

3,421 bytes

40d24d56357a26a2…

skills/cosmosdb-best-practices/rules/model-numeric-precision.md

skill

3,324 bytes

a6fb622e0e1ba833…

skills/cosmosdb-best-practices/rules/model-reference-large.md

skill

2,313 bytes

a7e64a65da349437…

skills/cosmosdb-best-practices/rules/model-relationship-references.md

skill

3,664 bytes

d39438edff3ddf64…

skills/cosmosdb-best-practices/rules/model-schema-versioning.md

skill

2,893 bytes

b4d25827b2268cb9…

skills/cosmosdb-best-practices/rules/model-ttl-expiration.md

skill

3,174 bytes

72b6bec7a39b9d7e…

skills/cosmosdb-best-practices/rules/model-type-discriminator.md

skill

3,583 bytes

da9bacbd92590858…

skills/cosmosdb-best-practices/rules/monitoring-azure-monitor.md

skill

4,531 bytes

2646749ecbbf74a0…

skills/cosmosdb-best-practices/rules/monitoring-diagnostic-logs.md

skill

5,204 bytes

e48ee0e530fcbeb7…

skills/cosmosdb-best-practices/rules/monitoring-latency.md

skill

4,303 bytes

f929669f1c783331…

skills/cosmosdb-best-practices/rules/monitoring-ru-consumption.md

skill

7,632 bytes

fc4c9f78d10528bc…

skills/cosmosdb-best-practices/rules/monitoring-throttling.md

skill

4,491 bytes

06c30f187c8a46df…

skills/cosmosdb-best-practices/rules/partition-20gb-limit.md

skill

2,893 bytes

89f00c431b47be94…

skills/cosmosdb-best-practices/rules/partition-avoid-hotspots.md

skill

3,478 bytes

9e3c4efb450e76c5…

skills/cosmosdb-best-practices/rules/partition-hierarchical.md

skill

5,826 bytes

ff086e6ea2225c33…

skills/cosmosdb-best-practices/rules/partition-high-cardinality.md

skill

2,234 bytes

8fe4b00d4ad59a43…

skills/cosmosdb-best-practices/rules/partition-immutable-key.md

skill

1,812 bytes

1c7cd384b17a94ce…

skills/cosmosdb-best-practices/rules/partition-key-length.md

skill

2,892 bytes

2f731bb07a396ad0…

skills/cosmosdb-best-practices/rules/partition-query-patterns.md

skill

2,747 bytes

14534d35384c7555…

skills/cosmosdb-best-practices/rules/partition-rekey-migration.md

skill

4,470 bytes

9f442fdf7308ec4a…

skills/cosmosdb-best-practices/rules/partition-synthetic-keys.md

skill

3,914 bytes

de2c609494109dd8…

skills/cosmosdb-best-practices/rules/pattern-ai-grounding-access.md

skill

4,862 bytes

05da37ee862b9033…

skills/cosmosdb-best-practices/rules/pattern-background-task-writes.md

skill

2,907 bytes

88c66d395746954b…

skills/cosmosdb-best-practices/rules/pattern-change-feed-materialized-views.md

skill

11,559 bytes

6fb61186fdc08f44…

skills/cosmosdb-best-practices/rules/pattern-efficient-ranking.md

skill

6,053 bytes

06cdc516ee2c6afa…

skills/cosmosdb-best-practices/rules/pattern-langgraph-agent-name-attribution.md

skill

2,239 bytes

34255586e82c7132…

skills/cosmosdb-best-practices/rules/pattern-langgraph-agent-routing-cosmosdb.md

skill

4,690 bytes

dad99c6d2e3a92ec…

skills/cosmosdb-best-practices/rules/pattern-langgraph-async-cosmos-routing.md

skill

3,286 bytes

7474330f45831b36…

skills/cosmosdb-best-practices/rules/pattern-langgraph-async-cosmos-writes.md

skill

2,951 bytes

03c8ce3d9cbce570…

skills/cosmosdb-best-practices/rules/pattern-langgraph-chat-history-separate.md

skill

3,431 bytes

60fb5a65c942fbfb…

skills/cosmosdb-best-practices/rules/pattern-langgraph-fastapi-startup.md

skill

3,146 bytes

f9cef9ebe28e1e8d…

skills/cosmosdb-best-practices/rules/pattern-langgraph-interrupt-human.md

skill

3,745 bytes

e7db2f9621419dab…

skills/cosmosdb-best-practices/rules/pattern-langgraph-multi-agent.md

skill

4,332 bytes

8afedeff75913be7…

skills/cosmosdb-best-practices/rules/pattern-langgraph-resume-checkpoint.md

skill

3,213 bytes

00b48b3609ecaa8d…

skills/cosmosdb-best-practices/rules/pattern-service-layer-relationships.md

skill

4,878 bytes

890963bf62fba793…

skills/cosmosdb-best-practices/rules/query-aggregate-single-pass.md

skill

2,722 bytes

6c37e9d06e106508…

skills/cosmosdb-best-practices/rules/query-avoid-cross-partition.md

skill

4,364 bytes

8043874c11ce37de…

skills/cosmosdb-best-practices/rules/query-avoid-scans.md

skill

2,569 bytes

dbf680e5ab22be57…

skills/cosmosdb-best-practices/rules/query-distinct-keyword.md

skill

2,315 bytes

e90071935176f40a…

skills/cosmosdb-best-practices/rules/query-latest-by-timestamp.md

skill

2,223 bytes

990694138e614e0b…

skills/cosmosdb-best-practices/rules/query-olap-detection.md

skill

5,064 bytes

32d0cb812ea1d7ba…

skills/cosmosdb-best-practices/rules/query-order-filters.md

skill

4,810 bytes

41ccd799324cb081…

skills/cosmosdb-best-practices/rules/query-pagination.md

skill

7,846 bytes

8e89b3da32a09464…

skills/cosmosdb-best-practices/rules/query-parameterize.md

skill

3,833 bytes

d288b6b9046103fc…

skills/cosmosdb-best-practices/rules/query-point-reads.md

skill

9,916 bytes

4b5e9585739d51a1…

skills/cosmosdb-best-practices/rules/query-top-literal.md

skill

1,928 bytes

ba14ef4a0ed2380f…

skills/cosmosdb-best-practices/rules/query-use-projections.md

skill

5,660 bytes

62a6f89e58694ef2…

skills/cosmosdb-best-practices/rules/sdk-async-api.md

skill

3,291 bytes

84d43888bf3af1e9…

skills/cosmosdb-best-practices/rules/sdk-availability-strategy.md

skill

5,405 bytes

21eeef5548eaf6ec…

skills/cosmosdb-best-practices/rules/sdk-circuit-breaker.md

skill

8,576 bytes

b3aeb13c91aaad31…

skills/cosmosdb-best-practices/rules/sdk-conditional-create-etag.md

skill

2,867 bytes

5cc9563deb962b1d…

skills/cosmosdb-best-practices/rules/sdk-connection-mode.md

skill

2,969 bytes

38b870cb193a9d08…

skills/cosmosdb-best-practices/rules/sdk-continuation-token-null-guard.md

skill

3,308 bytes

a185c4c9a2393a39…

skills/cosmosdb-best-practices/rules/sdk-diagnostics.md

skill

6,822 bytes

60064154feb522b3…

Browse all 158 files