Skip to content
Get packs

Cosmos DB NoSQL Data Modeling

Guides an agent through gathering requirements and designing an Azure Cosmos DB NoSQL data model

Source Download skill
Repository
github/awesome-copilot
Stars
40,703
Licence
MIT
Files
1 file

What it does

When installed, the agent acts as a pair-programming guide for designing a database schema for Azure Cosmos DB, a Microsoft NoSQL cloud database. It asks a few focused questions about your app's entities, read and write patterns, request volumes and concurrency, then records them in a cosmosdb_requirements.md file. It then proposes a document and container design in cosmosdb_data_model.md, using common NoSQL design patterns such as embedding versus separate containers and partition key choice.

Great for

  • Developers starting a new app on Azure Cosmos DB who want a structured design process
  • Teams migrating from relational databases who need help deciding what to embed and what to separate
  • Engineers planning for high write volumes who want guidance on batching and partitioning

Skip it if

  • Projects using SQL databases such as PostgreSQL or SQL Server, since the guidance is specific to Cosmos DB NoSQL (the design is not transferable as-is)
  • Users who only need a quick answer; the process is multi-step and asks many questions, which can be slow for simple schemas
  • Anyone expecting it to size costs or validate a design against a live database, since it only works from the conversation and produces Markdown files

Try asking

  • “Help me design a Cosmos DB data model for an e-commerce app with users, orders and products”
  • “Walk me through capturing access patterns and RPS for a multi-tenant SaaS backend on Cosmos DB”
  • “Review my plan for storing IoT sensor writes at 20k writes per second in Cosmos DB”
Step-by-step guide: how to use Cosmos DB NoSQL Data ModelingInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    cosmosdb-datamodeling.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip cosmosdb-datamodeling.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip cosmosdb-datamodeling.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Come prepared with rough numbers: expected users, requests per second per access pattern, and typical document sizes, since the skill asks for these
  • Answer the skill's questions in small batches, as it is designed to ask only one to three at a time
  • Keep the generated cosmosdb_requirements.md updated and review cosmosdb_data_model.md before implementing, since the design is advisory and should be validated with Azure's own tools

What's inside

  • SKILL.md

Redistributed unmodified from github/awesome-copilot under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.