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-skills/skills/mongodb-schema-design/SKILL.md
Source commit 4f2b4bc9a74024397b4688cbafd1ae538a83a5fb
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 4, 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)
- 1,200
- Repository last updated
- Nov 7, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- claude-code Repository topic
- github Repository topic
- commit-message Repository topic
- pull-requests Repository topic
- cursor Repository topic
- gemini-cli Repository topic
- codex Repository topic
- codex-cli Repository topic
- plugin Repository topic
- ai-agents 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