General principles for structured content modeling that apply across CMSs, with Sanity-specific guidance. Use when designing content schemas, planning content architecture, or evaluating content reuse strategies.
Add this skill
npx mdskills install sanity-io/content-modeling-best-practicesWell-structured content modeling principles with clear triggers and organized resource references
1---2name: content-modeling-best-practices3description: General principles for structured content modeling that apply across CMSs, with Sanity-specific guidance. Use when designing content schemas, planning content architecture, or evaluating content reuse strategies.4license: MIT5metadata:6 author: sanity7 version: "1.0.0"8---910# Content Modeling Best Practices1112Principles for designing structured content that's flexible, reusable, and maintainable. These concepts apply to any headless CMS but include Sanity-specific implementation notes.1314## When to Apply1516Reference these guidelines when:17- Starting a new project and designing the content model18- Evaluating whether content should be structured or free-form19- Deciding between references and embedded content20- Planning for multi-channel content delivery21- Refactoring existing content structures2223## Core Principles24251. **Content is data, not pages** — Structure content for meaning, not presentation262. **Single source of truth** — Avoid content duplication273. **Future-proof** — Design for channels that don't exist yet284. **Editor-centric** — Optimize for the people creating content2930## Resources3132See `resources/` for detailed guidance on specific topics:33- `resources/separation-of-concerns.md` — Separating content from presentation34- `resources/reference-vs-embedding.md` — When to use references vs embedded objects35- `resources/content-reuse.md` — Content reuse patterns and the reuse spectrum36- `resources/taxonomy-classification.md` — Flat, hierarchical, and faceted classification37
Full transparency — inspect the skill content before installing.