Modeling Content

Design semantic content models for AEM Edge Delivery blocks.

Updated Oct 7, 2025
One-click install
npx skills add https://github.com/blakebauman/aem-camp --skill modeling-content-blakebauman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Modeling Content
Source: https://github.com/blakebauman/aem-camp/tree/main/.claude/skills/content-modeling
Command: npx skills add https://github.com/blakebauman/aem-camp --skill modeling-content-blakebauman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Poorly designed content models lead to author frustration, inconsistent content, and difficult-to-maintain code. This skill guides developers in creating intuitive, semantic, and reusable content structures for AEM Edge Delivery blocks, ensuring a smooth authoring experience.

Core Features & Use Cases

  • Canonical Model Selection: Helps choose the best of 4 core content model types (Standalone, Collection, Configuration, Auto-Blocked) to fit your block's purpose.
  • Table Structure Design: Guides the creation of flexible, semantic HTML table structures that are easy for authors to understand and populate in their CMS.
  • Best Practice Validation: Ensures your content models are predictable, reusable, and minimize required author input, reducing errors and improving efficiency.
  • Use Case: When designing a new "hero" block, use this skill to determine if a Standalone model is best, then design a flexible table structure that allows authors to easily input images, headings, and CTAs without rigid constraints.

Quick Start

Design a content model for a new "tabs" block, considering auto-blocking patterns.

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?

Designing content models for AEM Edge Delivery blocks involves selecting one of four canonical types—Standalone, Collection, Configuration, or Auto-Blocked—based on your block's purpose, then structuring semantic HTML tables that authors can reliably populate without rigid constraints.

What's the best way to structure tables for author-friendly AEM blocks?

Create flexible, semantic table structures with a maximum of four cells per row, using decoration-ready patterns and consistent query selectors across models. This enables predictable authoring and maintains cross-model consistency while minimizing required author input.

When should I use Standalone versus Collection content models in AEM?

Use Standalone models for single-instance content like hero blocks where authors input one set of data. Use Collection models when authors need to compose multiple similar content items together, like a series of tabs or cards.

How do I ensure my AEM block content model is reusable and maintainable?

Apply semantic formatting conventions, maintain consistent cell limits and decoration patterns across canonical model types, and design table structures that enforce predictable authoring workflows, reducing errors and code maintenance burden.

Can I migrate existing AEM blocks to follow these content model patterns?

Yes. Migrating blocks to canonical models involves auditing your current table structures, selecting the appropriate model type for each block's purpose, and restructuring to conform to semantic formatting, cell limits, and cross-model consistency requirements.

What are the limitations of auto-blocking patterns in AEM content models?

Auto-Blocked models impose strict structural constraints to enable automatic block detection. Use them only when predictable, machine-parseable row patterns are acceptable; avoid them for blocks requiring flexible or varied row compositions.