content-modeling-best-practices

What problem does it solve?

This Skill addresses the challenges of creating flexible, reusable, and maintainable content models for headless CMS platforms, preventing common pitfalls like presentation-driven schemas and content duplication.

Core Features & Use Cases

• Schema Design Guidance: Provides principles for structuring content semantically.
• Content Reuse Strategies: Details patterns for shared components, field sets, and fragments.
• Reference vs. Embedding: Explains when to link content versus embedding it directly.
• Taxonomy Best Practices: Offers guidance on flat, hierarchical, and faceted classification.
• Use Case: When designing a new content type for a blog post, use this skill to ensure you're structuring fields like 'author' and 'tags' for reusability and separation of concerns, rather than tying them directly to how they will be displayed on a specific page.

Quick Start

Use the content-modeling-best-practices skill to understand when to use references versus embedded objects for content.