authoring-analysis

Decide between default content and AEM blocks for content sequences.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/aemsites/koassets --skill authoring-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-analysis
Source: https://github.com/aemsites/koassets/tree/main/.claude/skills/authoring-analysis
Command: npx skills add https://github.com/aemsites/koassets --skill authoring-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the critical decision-making process in content migration, determining whether content sequences should be default HTML or mapped to specific AEM blocks. It ensures optimal authoring experience, correct styling, and prevents common migration errors.

Core Features & Use Cases

  • Default Content Prioritization: First checks if content can be authored as simple text (headings, paragraphs, links), minimizing unnecessary block usage and simplifying authoring.
  • Intelligent Block Selection: Guides the choice of appropriate AEM blocks based on content patterns and available inventory, invoking content-modeling for ambiguous cases.
  • Block Structure Retrieval: Critically fetches pre-decoration HTML structures for all selected blocks, preventing the #1 HTML generation error: incorrect structure.
  • Section Styling Validation: Validates section background styling for single-block sections to avoid conflicts with block-specific designs, ensuring visual consistency.
  • Use Case: After identifying page structure, use this skill to decide if a "grid of 8 items with icons" should be a "Cards block" or if "large centered heading, paragraph, two buttons" should be "DEFAULT CONTENT," ensuring a streamlined and accurate authoring experience.

Quick Start

Use the authoring-analysis skill to analyze the identified content sequences and block inventory, and determine the authoring approach for each sequence.

Frequently Asked Questions about authoring-analysis

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

FAQPage Schema
How do I decide between default content and AEM blocks when migrating content?

Default content prioritization checks if content sequences can be authored as simple text (headings, paragraphs, links) first, minimizing unnecessary block usage. Use authoring-analysis to evaluate each content sequence against your block inventory and apply this decision process to determine the optimal authoring approach for migration to AEM Edge Delivery Services.

What's the correct HTML structure for AEM blocks during content migration?

Authoring-analysis fetches pre-decoration HTML structures for all selected blocks to prevent incorrect structure generation, the #1 error in HTML output. It retrieves the proper block structures needed for import-ready HTML guidance before migration.

How do I map content sequences to the right AEM blocks?

Identify page sections and their content sequences, then use authoring-analysis to select appropriate blocks based on content patterns and your available block inventory. For ambiguous cases, the skill invokes content-modeling to guide block selection and ensure optimal authoring experience.

Can I use default styling for single-block sections in AEM?

Authoring-analysis validates section background styling for single-block sections to avoid conflicts with block-specific designs. Check styling constraints before applying defaults to ensure visual consistency across your migrated content.

When should I use block-based composition instead of default HTML?

Use block-based composition when content patterns require specific styling, structured layouts, or use cases defined by David's Model that default HTML cannot achieve. Authoring-analysis evaluates whether a sequence like 'grid of 8 items with icons' needs a Cards block or if simple content should remain as default text.

Do I need to define section boundaries before using authoring-analysis?

Yes. Authoring-analysis requires identified page structures with section boundaries, content sequences per section, and your available block inventory as prerequisites. First identify the page structure, then apply this skill to determine authoring decisions for each sequence.