content-modeling-best-practices▌
sanity-io/agent-toolkit · updated Apr 8, 2026
Structured content modeling guidance for schema design, reusability, and multi-channel delivery.
- ›Covers core principles: treating content as data rather than pages, maintaining single sources of truth, designing for future channels, and optimizing for editor workflows
- ›Includes decision frameworks for references versus embedded objects, separation of concerns, and content reuse patterns
- ›Provides taxonomy and classification guidance for flat, hierarchical, and faceted approaches
- ›App
Content Modeling Best Practices
Principles for designing structured content that's flexible, reusable, and maintainable. These concepts apply to any headless CMS but include Sanity-specific implementation notes.
When to Apply
Reference these guidelines when:
- Starting a new project and designing the content model
- Evaluating whether content should be structured or free-form
- Deciding between references and embedded content
- Planning for multi-channel content delivery
- Refactoring existing content structures
Core Principles
- Content is data, not pages — Structure content for meaning, not presentation
- Single source of truth — Avoid content duplication
- Future-proof — Design for channels that don't exist yet
- Editor-centric — Optimize for the people creating content
Resources
Start with the resource that matches the modeling decision in front of you, instead of loading every topic at once. See resources/ for detailed guidance on specific topics:
resources/separation-of-concerns.md— Separating content from presentationresources/reference-vs-embedding.md— When to use references vs embedded objectsresources/content-reuse.md— Content reuse patterns and the reuse spectrumresources/taxonomy-classification.md— Flat, hierarchical, and faceted classification
Ratings
4.5★★★★★10 reviews- ★★★★★Shikha Mishra· Oct 10, 2024
content-modeling-best-practices is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Piyush G· Sep 9, 2024
Keeps context tight: content-modeling-best-practices is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Chaitanya Patil· Aug 8, 2024
Registry listing for content-modeling-best-practices matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Sakshi Patil· Jul 7, 2024
content-modeling-best-practices reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Ganesh Mohane· Jun 6, 2024
I recommend content-modeling-best-practices for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Oshnikdeep· May 5, 2024
Useful defaults in content-modeling-best-practices — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Dhruvi Jain· Apr 4, 2024
content-modeling-best-practices has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Rahul Santra· Mar 3, 2024
Solid pick for teams standardizing on skills: content-modeling-best-practices is focused, and the summary matches what you get after install.
- ★★★★★Pratham Ware· Feb 2, 2024
We added content-modeling-best-practices from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Yash Thakker· Jan 1, 2024
content-modeling-best-practices fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.