mongodb-schema-design SKILL.md skillA

mongodb-schema-design from fcakyon/claude-codex-settings is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add fcakyon/claude-codex-settings/mongodb-schema-design@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
fcakyon/claude-codex-settings
Path
plugins/mongodb-skills/skills/mongodb-schema-design/SKILL.md
Versions recorded
2
Latest version
v1.0.0, committed Jul 20, 2026
First version recorded
Mar 31, 2026
Size
13,647 bytes
Repository stars
1,200
License
Apache-2.0

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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
- Seeing Atlas Schema Suggestions or Performance Advisor warnings
- Hitting the 16MB document limit
- Adding schema validation to existing collections

## Quick Reference

### 1. Schema Anti-Patterns - 3 rules

- [antipattern-unnecessary-collections](references/antipattern-unnecessary-collections.md) - Splitting homogeneous data into multiple collections is often an anti-pattern; consult this reference to validate whether this is the case.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add fcakyon/claude-codex-settings/mongodb-schema-design@sha256:2a19fcd1a85b9573

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_cnqhdj52iqqjonr6.svg)](https://markdownregistry.com/a/art_cnqhdj52iqqjonr6)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Mar 31, 2026 and Jul 20, 2026, about one every 111 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-07-20 d26d2c8 13,647 BA view · diff
git:20260331.046d1ef2026-03-31 046d1ef 11,040 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13647 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

fcakyon/claude-codex-settings · 1,200 stars · license Apache-2.0 · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cnqhdj52iqqjonr6
GET https://markdownregistry.com/api/v1/resolve?ref=fcakyon/claude-codex-settings/mongodb-schema-design
GET https://markdownregistry.com/api/v1/blob/2a19fcd1a85b957301898c7c26f691bdf5da65d94c6ab0c6fc3609dc8205eb08

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from fcakyon/claude-codex-settings

CLAUDE.md@.claude CLAUDE.md file
fcakyon/claude-codex-settings · .claude/CLAUDE.md
git:20261107.0574bbb · audit A · 1,200 stars
AGENTS.md AGENTS.md file
fcakyon/claude-codex-settings · AGENTS.md
git:20251004.951ae6c · audit B · 1,200 stars
CLAUDE.md CLAUDE.md file
fcakyon/claude-codex-settings · CLAUDE.md
git:20261108.4e309a7 · audit A · 1,200 stars
adhd-output-style SKILL.md skill
fcakyon/claude-codex-settings · plugins/adhd-output-style/skills/adhd-output-style/SKILL.md · This skill should be used when the user asks for "ADHD output", "fewer output tokens", "short numbered steps", "limited…
git:20260721.7c9b5ff · audit A · 1,200 stars
aeo SKILL.md skill
fcakyon/claude-codex-settings · plugins/aeo/skills/aeo/SKILL.md · This skill should be used when the user asks to "build an AEO strategy", "improve AI search visibility", "track buyer…
git:20261028.a9921a5 · audit A · 1,200 stars
agent-browser SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/agent-browser/SKILL.md · Agent-browser usage guide. Read this before running any agent-browser commands. Covers the snapshot-and-ref workflow…
git:20261026.312fc10 · audit A · 1,200 stars
derive-client SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/derive-client/SKILL.md · Reverse-engineer a website's internal API by recording browser traffic into a HAR file, then generate a standalone…
git:20261001.f7836da · audit A · 1,200 stars
dogfood SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/dogfood/SKILL.md · Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to…
git:20261001.f7836da · audit A · 1,200 stars
electron SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/electron/SKILL.md · Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome…
git:20260401.ce7d4ce · audit A · 1,200 stars
ui-regression SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/ui-regression/SKILL.md · This skill should be used when the user asks to "verify UI changes", "audit UI quality", "test every screen and…
git:20261028.7007d7e · audit A · 1,200 stars
webmcp-gen SKILL.md skill
fcakyon/claude-codex-settings · plugins/agent-browser/skills/webmcp-gen/SKILL.md · Build and validate experimental WebMCP tools for an existing web page. Use when an agent needs to expose a site's real…
git:20261001.f7836da · audit A · 1,200 stars
docx SKILL.md skill
fcakyon/claude-codex-settings · plugins/anthropic-office-skills/skills/docx/SKILL.md · Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word…
git:20260720.d26d2c8 · audit A · 1,200 stars

Every file in fcakyon/claude-codex-settings

Browse by kind, by grade A, or by owner.