authoring-analysis

Classify content sequences as default content or structured blocks for AEM Edge Delivery imports.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/thojava/baco --skill authoring-analysis-thojava
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-analysis
Source: https://github.com/thojava/baco/tree/main/.skills/authoring-analysis
Command: npx skills add https://github.com/thojava/baco --skill authoring-analysis-thojava

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Determine whether each content sequence on a page should be authored as simple default content or implemented as a structured block to ensure correct import, consistent authoring, and reliable HTML generation for AEM Edge Delivery Services. This prevents mismatches between author intent and block structure that cause layout errors, incorrect decoration, or unnecessary section metadata.

Core Features & Use Cases

  • Per-sequence authoring decisions: Implements a mandatory default-content-first check, then a block-selection decision tree to classify sequences.
  • Validation and discovery: Triggers content-modeling for ambiguous cases and invokes block-collection checks when blocks are missing from the inventory.
  • Section styling validation: Executes a focused step for single-block sections to decide whether to keep or skip section-level metadata based on screenshot analysis.
  • Use Case: During a page-import workflow, analyze identified sections, sequences, and a block inventory to produce a deterministic mapping of default content vs blocks and a validated section-styling plan for downstream HTML generation.

Quick Start

Run authoring analysis on the identified page structure, content sequences, block inventory, and screenshot to produce sequence decisions and validated section-styling.

Frequently Asked Questions about authoring-analysis

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

FAQPage Schema
How do I decide whether to use default content or a structured block during AEM content migration?

AEM content modeling distinguishes default content from structured blocks by checking if a sequence needs simple paragraph styling or complex block decoration. This requires a block inventory to validate available blocks before classifying sequences for import.

How do I validate section styling for single-block sections in AEM Edge Delivery Services?

Section styling validation analyzes page screenshots for single-block sections to decide whether section-level metadata should be kept or skipped, preventing layout errors and incorrect block decoration during HTML generation.

What do I need to run an authoring analysis for a page-import workflow?

Authoring analysis requires pages with predefined section boundaries, neutral sequence descriptions, a block inventory, section styling notes, and a screenshot for visual validation to produce deterministic block selections and metadata decisions.

Can I trigger content-modeling for ambiguous sequences when selecting blocks?

Yes, content-modeling is triggered for ambiguous cases during block selection, and block-collection checks are invoked when required blocks are missing from the available block inventory.

Why does my structured block cause layout errors during AEM content migration?

Layout errors during content migration occur when there is a mismatch between author intent and block structure, often caused by applying section metadata unnecessarily or selecting an incorrect block for a content sequence.