{
  "markdown": "# Azure Cosmos DB Plugin for Claude Code\n\nThe Azure Cosmos DB plugin for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) gives Claude deep expertise in Azure Cosmos DB best practices, data modeling, query optimization, and SDK usage — ready to use immediately after install with no configuration required.\n\n## Install\n\nInstall from the official Anthropic marketplace:\n\n```\n/plugin install azure-cosmos-db-assistant@claude-plugins-official\n/reload-plugins\n```\n\n> **Note:** Earlier versions of this plugin used the namespace `/azure-cosmosdb:*`.\n> The plugin now uses `/azure-cosmos-db-assistant:*` to align with the official marketplace entry and improve discoverability.\n\n## Works Out of the Box\n\nThis plugin installs cleanly with **no required environment variables, no external services, and no auto-running binaries**. All skills, the expert agent, and commands are available immediately.\n\n## What's Included\n\n- **Skills** — 73 best-practice rules across 10 categories covering data modeling, partition key design, query optimization, SDK patterns, indexing, throughput, global distribution, monitoring, design patterns, and vector search — sourced from the [cosmosdb-agent-kit](https://github.com/AzureCosmosDB/cosmosdb-agent-kit)\n- **Agent** — A specialized Cosmos DB expert agent for in-depth guidance\n- **Commands** — Code review and skill regeneration commands\n\n## Optional: MCP Toolkit Integration\n\nFor users who want to connect Claude Code to a **live Azure Cosmos DB account**, the optional [Azure Cosmos DB MCP Toolkit](https://github.com/AzureCosmosDB/MCPToolKit) integration adds database operations, schema discovery, and vector search. This requires a separate deployment and is **not required** for the plugin to function.\n\nSee [SETUP.md](SETUP.md) for full integration instructions.\n\n## Getting Started\n\nAfter installing the plugin, try these in Claude Code:\n\n### Commands\n\n```\n/azure-cosmos-db-assistant:cosmos-review     # Review your code for Cosmos DB best practices\n/azure-cosmos-db-assistant:generate-skills   # Regenerate skills from upstream agent-kit\n/azure-cosmos-db-assistant:cosmos-setup      # Configure optional MCP Toolkit connection\n```\n\n### Agent\n\n```\n/agents cosmosdb-expert\n```\n\n### Example Questions\n\n- \"Review my Cosmos DB data model for this application\"\n- \"What partition key should I use for a multi-tenant SaaS app?\"\n- \"Optimize this Cosmos DB query for lower RU cost\"\n- \"Should I embed or reference this related data?\"\n- \"Review my Cosmos DB code for best practices\"\n- \"How do I set up vector search in Cosmos DB for RAG?\"\n\n## Project Structure\n\n```\ncosmosdb-claude-code-plugin/\n├── .claude-plugin/\n│   └── plugin.json                 # Plugin manifest\n├── .mcp.example.json               # Example MCP config (copy to .mcp.json to activate)\n├── agents/\n│   └── cosmosdb-expert.md          # Specialized Cosmos DB expert agent\n├── commands/\n│   ├── cosmos-setup.md             # Optional MCP Toolkit setup command\n│   ├── cosmos-review.md            # Code review command\n│   └── generate-skills.md          # Regenerate skills from agent-kit\n├── skills/\n│   └── cosmosdb-best-practices/\n│       ├── SKILL.md                # Skill manifest and rule index\n│       └── rules/                  # 73 individual best-practice rule files\n│           ├── model-*.md          # Data modeling (11 rules)\n│           ├── partition-*.md      # Partition key design (7 rules)\n│           ├── query-*.md          # Query optimization (6 rules)\n│           ├── sdk-*.md            # SDK best practices (19 rules)\n│           ├── index-*.md          # Indexing strategies (5 rules)\n│           ├── throughput-*.md     # Throughput & scaling (5 rules)\n│           ├── global-*.md         # Global distribution (6 rules)\n│           ├── monitoring-*.md     # Monitoring & diagnostics (5 rules)\n│           ├── pattern-*.md        # Design patterns (3 rules)\n│           └── vector-*.md         # Vector search (6 rules)\n├── assets/\n│   └── logo.svg                    # Plugin logo\n├── SETUP.md                        # Optional MCP Toolkit integration guide\n├── LICENSE\n└── README.md\n```\n\n## Keeping Skills Up to Date\n\nSkills are derived from the [AzureCosmosDB/cosmosdb-agent-kit](https://github.com/AzureCosmosDB/cosmosdb-agent-kit).\n\nTo regenerate skills after the upstream agent-kit updates:\n\n```\n/azure-cosmos-db-assistant:generate-skills\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch: `git checkout -b feature/my-feature`\n3. Commit your changes: `git commit -m 'feat: add my feature'`\n4. Push to the branch: `git push origin feature/my-feature`\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
  "bytes": 4824,
  "sha": "22c0240b2b8c4233c5c8b2b2add6bd27b7692d627535ca1a1d09f87681575eda",
  "repo_slug": "azurecosmosdb/cosmosdb-claude-code-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_azurecosmosdb_cosmosdb_claude_code_plugi_9f6856c2/readme"
}