authoring-analysis

Determine default-text versus block authoring and validate block availability for page migrations.

Updated Jan 16, 2026
One-click install
npx skills add https://github.com/treeves/ak-test --skill authoring-analysis-treeves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: authoring-analysis
Source: https://github.com/treeves/ak-test/tree/main/.skills/authoring-analysis
Command: npx skills add https://github.com/treeves/ak-test --skill authoring-analysis-treeves

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill determines the appropriate authoring approach for each content sequence, deciding between default content and blocks, and validates block selection and section styling for a smooth import/migration to AEM Edge Delivery Services.

Core Features & Use Cases

  • Default-content vs blocks decision: analyzes sequences to determine if content can be authored with plain typing or requires block components.
  • Block validation workflow: ensures required blocks exist, references, and HTML structure guidance, enabling consistent migrations.
  • Section-styling guidance: recommends when to apply section metadata based on styling in identify-page-structure outputs.

Quick Start

Feed the target page structure and block inventory to this skill and execute the Step 3 workflow to produce a sequence-by-sequence decision. Review the Step 3 outputs to finalize which sequences become blocks and whether section metadata is needed.

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 author content as default text or blocks during page migration?

Authoring-analysis evaluates each content sequence to determine if it should use plain typing or block components. It analyzes your page structure against your block inventory and produces sequence-by-sequence guidance, helping you choose the right authoring approach for consistent AEM Edge Delivery Services migrations.

What's the best way to validate blocks exist before migrating pages?

This skill validates block selection and existence as part of a multi-step workflow. It checks your block collection, confirms required blocks are available, retrieves HTML structure guidance, and ensures references are valid—so migrations proceed without missing or broken block dependencies.

Can I use section-styling guidance with page-import workflows?

Yes. Authoring-analysis recommends when to apply section metadata based on styling detected in page structures. It integrates with page-import workflows and section structures to guide metadata decisions alongside block selection, enabling consistent styling across migrations.

How do I assess page structure for block-based authoring?

Feed your target page structure and block inventory to authoring-analysis and execute its Step 3 workflow. The skill analyzes sequences against available blocks and produces actionable decisions—which sequences become blocks, whether section metadata applies, and what HTML structure each requires.

What happens if required blocks aren't available during migration?

Authoring-analysis validates block existence during the workflow and flags unavailable blocks before migration. The block validation step ensures your block collection contains all required references, letting you address gaps early and maintain consistency across page imports.