aem-skill-content-modeling

Designs author-friendly content models for AEM Edge Delivery Services blocks.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill aem-skill-content-modeling-capella-hotel-group
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aem-skill-content-modeling
Source: https://github.com/capella-hotel-group/capella-hotel-group-poc/tree/main/.github/skills/aem-skill-content-modeling
Command: npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill aem-skill-content-modeling-capella-hotel-group

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing block content structures for AEM Edge Delivery Services is error-prone: models with too many columns, spreadsheet-like header rows, or misused configuration patterns make authoring painful in Google Docs, SharePoint, and the Universal Editor. This Skill provides a structured four-step workflow to design semantic, predictable, and reusable content models before any TypeScript block code is written. ## Core Features & Use Cases - Four canonical model patterns: Guides selection among Standalone, Collection, Configuration, and Auto-Blocked models with good and bad examples drawn from real project blocks (hero, cards, activities). - Validation checklist: Enforces best practices such as the 4-cells-per-row maximum, semantic formatting over config cells, and block variants instead of style key-value pairs. - Advanced scenario guidance: Covers nested blocks, item-level configuration in collections, list handling, and form modeling strategies. - Use Case: When creating a new cards block, invoke this Skill during Step 3 of content-driven development to produce a documented table structure that authors can use across Google Docs, SharePoint, and the Universal Editor. ## Quick Start Ask the AI to design a content model for a new AEM Edge Delivery block, describing the block's purpose and required content elements.

Frequently Asked Questions about aem-skill-content-modeling

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

FAQPage Schema
How do I design a content model for an AEM Edge Delivery block?▼

Follow a four-step workflow: understand content requirements, design the block structure using one of the four canonical models, validate against best practices like the 4-cell maximum, then document the model as a markdown table for the calling skill or developer.

What are the canonical block models in AEM Edge Delivery Services?▼

There are four canonical models: Standalone for unique elements like heroes, Collection for repeating items like cards, Configuration for API-driven dynamic content only, and Auto-Blocked for pattern-detected structures like tabs.

When should I use the Configuration model for a block?▼

Use the Configuration model only for API-driven or dynamic content where key-value settings control behavior or data fetching, such as blog listings or search results. Never use it for static content that fits Standalone or Collection patterns.

How do I handle nested blocks in AEM content models?▼

Use auto-blocking with consecutive sections sharing section metadata (e.g., style | tabs) so each section becomes a tab, or link to fragments containing the inner blocks. Choose auto-blocking for predictable patterns and fragments for complex or reused content.

What content modeling mistakes should authors avoid?▼

Avoid exceeding four cells per row, spreadsheet-like header rows in collections, configuration cells for static content, non-semantic cell splitting, and requiring authors to input data that could be inferred. Use block variants like | Hero (Dark) | instead of style cells.