How does this skill improve the editing experience?

It provides 'editor-centric' principles that focus on making content intuitive to create and manage, ensuring the backend structure reflects the mental model of the content creators.

Does this skill work with CMS platforms other than Sanity?

Yes. While it contains Sanity-specific implementation notes, the core principles of structured content modeling are universal and apply to any headless CMS like Contentful, Strapi, or Hygraph.

When is the best time to use this Claude Code skill?

Use it during the discovery and planning phases of a project, when defining your data types, or when troubleshooting issues related to content duplication and rigid schemas.

What is the 'Content is data, not pages' principle?

It is a core philosophy that suggests content should be modeled based on its inherent meaning and relationships rather than how it looks on a specific webpage, allowing it to be used across different platforms and devices.

Structured Content Modeling

Name: Structured Content Modeling
Author: sanity-io

bysanity-io

•

Content Management

Guides the design of flexible, reusable, and maintainable structured content schemas for headless CMS architectures.

This skill provides a comprehensive framework for architecting content models that prioritize data integrity and reuse over presentation. It helps developers navigate complex decisions such as choosing between references and embedded content, implementing effective taxonomies, and ensuring a single source of truth. While offering specific guidance for Sanity.io, the core principles are applicable to any headless CMS, ensuring your content remains future-proof and optimized for multi-channel delivery and editor efficiency.

Key Features

01Best practices for taxonomy and content classification

02Strategies for content reuse and avoiding duplication

03Decision frameworks for content referencing vs. embedding

04Guidance on separating content meaning from visual presentation

05Schema design patterns for flexible headless CMS architecture

0662 GitHub stars

Use Cases

01Refactoring monolithic content structures into reusable components

02Planning content schemas for multi-channel digital experiences

03Designing the initial content architecture for a new web or mobile project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sanity-io/agent-toolkit content-modeling-best-practices

For use in Claude.ai and ChatGPT

Download Skill