content-modeling-best-practices

sanity-io/agent-toolkit · updated Apr 8, 2026

$npx skills add https://github.com/sanity-io/agent-toolkit --skill content-modeling-best-practices
0 commentsdiscussion
summary

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
skill.md

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

  1. Content is data, not pages — Structure content for meaning, not presentation
  2. Single source of truth — Avoid content duplication
  3. Future-proof — Design for channels that don't exist yet
  4. 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 presentation
  • resources/reference-vs-embedding.md — When to use references vs embedded objects
  • resources/content-reuse.md — Content reuse patterns and the reuse spectrum
  • resources/taxonomy-classification.md — Flat, hierarchical, and faceted classification

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.643 reviews
  • Soo Khanna· Dec 28, 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.

  • Mateo Chawla· Dec 28, 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· Dec 24, 2024

    I recommend content-modeling-best-practices for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Maya Reddy· Dec 12, 2024

    Registry listing for content-modeling-best-practices matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Maya Mensah· Nov 19, 2024

    content-modeling-best-practices is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Amelia Gupta· Nov 19, 2024

    Registry listing for content-modeling-best-practices matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Maya Khan· Nov 7, 2024

    content-modeling-best-practices reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Jin Mensah· Nov 3, 2024

    Solid pick for teams standardizing on skills: content-modeling-best-practices is focused, and the summary matches what you get after install.

  • Maya Huang· Oct 26, 2024

    I recommend content-modeling-best-practices for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Charlotte Ramirez· Oct 22, 2024

    We added content-modeling-best-practices from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 43

1 / 5