Back to skills

mongodb-schema-design

data

A collection of MongoDB schema design patterns and anti-patterns from MongoDB, covering embed-vs-reference decisions, the 16MB document limit, schema validation, and 11 data modeling patterns like buc

Setup & Installation

npx skills add https://github.com/mongodb/mongodb-schema-design --skill mongodb-schema-design
or paste the link and ask your coding assistant to install it
https://github.com/mongodb/mongodb-schema-design
View on GitHub

What This Skill Does

A collection of MongoDB schema design patterns and anti-patterns from MongoDB, covering embed-vs-reference decisions, the 16MB document limit, schema validation, and 11 data modeling patterns like bucket, polymorphic, and time series. Includes a decision framework for relationships and optional MCP integration to inspect live collections. Most MongoDB performance problems come from schema decisions, not query tuning, and this skill gives you the specific pattern names and trade-off tables MongoDB's own engineers use to diagnose them.

When to use it

  • Working with mongodb schema design functionality
  • Implementing mongodb schema design features
  • Debugging mongodb schema design related issues