Modeling Content

Design semantic content models for AEM Edge Delivery blocks.

Updated Nov 9, 2025
One-click install
npx skills add https://github.com/treeves/opsinventor-eds --skill modeling-content-treeves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Modeling Content
Source: https://github.com/treeves/opsinventor-eds/tree/main/.ai-skills/skills/content-modeling
Command: npx skills add https://github.com/treeves/opsinventor-eds --skill modeling-content-treeves

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides developers in creating intuitive and maintainable content models for AEM Edge Delivery blocks, preventing authoring confusion and costly rework. It ensures that the underlying structure of your content is easy for authors to understand and use, leading to smoother content creation.

Core Features & Use Cases

  • Canonical Model Selection: Helps you choose the best content model type (Standalone, Collection, Configuration, Auto-Blocked) for any block, aligning with best practices.
  • Best Practice Validation: Provides a comprehensive checklist to ensure your content models are semantic, predictable, reusable, and author-friendly.
  • Use Case: When designing a new "Cards" block, this Skill helps you define a clear table structure that authors can easily understand and populate in their CMS. This reduces training time and ensures consistent content quality.

Quick Start

Design a content model for a new "Image Gallery" block, focusing on author-friendly structure and flexibility.

Frequently Asked Questions about Modeling Content

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a content model for AEM Edge Delivery blocks?

Design semantic, author-friendly content models by selecting the appropriate canonical type (Standalone, Collection, Configuration, or Auto-Blocked), structuring tables for clarity, and applying decoration-friendly patterns. This ensures reusable, predictable structures that reduce authoring confusion and rework.

What's the difference between Standalone, Collection, Configuration, and Auto-Blocked content models?

These are four canonical model types for AEM blocks. Standalone models represent single entities; Collection groups multiple items; Configuration holds shared settings; Auto-Blocked auto-generates block variants. Choosing the right type aligns your structure with best practices and author workflows.

How do I make content models author-friendly in AEM?

Apply semantic table design, use consistent naming conventions, minimize required fields, and structure data logically. Author-friendly models reduce training time, prevent mistakes, and ensure consistent content quality across your CMS.

When should I refactor or migrate an existing AEM content model?

Refactor when authoring becomes confusing, blocks change structure, or models drift from semantic best practices. Validation against canonical guidance, table design patterns, and decoration-friendly conventions helps identify when migration improves reusability and maintainability.

Can I apply content modeling best practices to existing blocks?

Yes. Validate existing blocks against semantic design, canonical model guidance, and decoration-friendly patterns. Modifying blocks that change authoring structure gives you the chance to apply best practices and improve author experience without full redesign.