Individual skill
mongodb-schema-design
MongoDB schema design patterns and anti-patterns. Use when designing data models, reviewing schemas, migrating from SQL, or troubleshooting performance issues caused by schema problems. Triggers on "design schema", "embed vs reference", "MongoDB data model", "schema review", "unbounded arrays", "one-to-many", "tree structure", "16MB limit", "schema validation", "JSON Schema", "time series", "schema migration", "polymorphic", "TTL", "data lifecycle", "archive", "index explosion", "unnecessary indexes", "approximation pattern", "document versioning".
plugins/mongodb-atlas/skills/mongodb-schema-design/SKILL.md
Source commit 155bb9c4b42a9a3e019f47be0669de0e4547d1ea
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 197
- Repository last updated
- Nov 8, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent Repository topic
- claude Repository topic
- cursor Repository topic
- gemini-cli-extension Repository topic
- mcp Repository topic
- skills Repository topic
- data Derived category
- design Derived category
- data-databases Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 13,647 bytesSKILL.mdcore · 13,647 bytesSKILL.mdcore · 13,647 bytesreferences/antipattern-excessive-lookups.mddoc · 3,608 bytesreferences/antipattern-unnecessary-collections.mddoc · 4,194 bytesreferences/antipattern-unnecessary-indexes.mddoc · 3,773 bytesreferences/fundamental-document-model.mddoc · 3,608 bytesreferences/fundamental-document-size.mddoc · 9,803 bytesreferences/fundamental-embed-vs-reference.mddoc · 15,238 bytesreferences/fundamental-schema-validation.mddoc · 4,382 bytesreferences/pattern-approximation.mddoc · 3,310 bytesreferences/pattern-archive.mddoc · 5,456 bytesreferences/pattern-attribute.mddoc · 2,485 bytesreferences/pattern-bucket.mddoc · 4,268 bytesreferences/pattern-computed.mddoc · 6,163 bytesreferences/pattern-document-versioning.mddoc · 5,143 bytesreferences/pattern-extended-reference.mddoc · 3,403 bytesreferences/pattern-outlier.mddoc · 5,760 bytesreferences/pattern-polymorphic.mddoc · 6,115 bytesreferences/pattern-schema-versioning.mddoc · 8,419 bytesreferences/pattern-time-series-collections.mddoc · 6,611 bytesreferences/source-query-stats.mddoc · 3,431 bytesreferences/source-slow-query-logs.mddoc · 2,345 bytes
Read excerpt
# MongoDB Schema Design
Data modeling patterns and anti-patterns for MongoDB, maintained by MongoDB. Bad schema is the root cause of most MongoDB performance and cost issues—queries and indexes cannot fix a fundamentally wrong model.
## When to Apply
Reference these guidelines when:
- Designing a new MongoDB schema from scratch
- Migrating from SQL/relational databases to MongoDB
- Reviewing existing data models for performance issues
- Troubleshooting slow queries or growing document sizes
- Deciding between embedding and referencing
- Modeling relationships (one-to-one, one-to-many, many-to-many)
- Implementing tree/hierarchical structures