aem-init

Detect AEM project structure and append an aem section to .ai/config.yaml.

6|3|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/easingthemes/dx-aem-flow --skill aem-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aem-init
Source: https://github.com/easingthemes/dx-aem-flow/tree/main/plugins/dx-aem/skills/aem-init
Command: npx skills add https://github.com/easingthemes/dx-aem-flow --skill aem-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the setup of AEM-related configuration for the dx workflow by detecting project structure and appending an aem section to the base configuration.

Core Features & Use Cases

  • Detects AEM project structure (component paths, frontend layout, and brands) and appends a aem: block to .ai/config.yaml to standardize DX governance.
  • Supports re-run validation to ensure all steps execute, including component index and discovery updates, shared rule extensions, and Copilot integration notes.
  • Enables consistent context for downstream skills to operate on AEM components, pages, and dialogs across repos.

Quick Start

Run /aem-init after /dx-init to configure AEM settings and append the aem section to your .ai/config.yaml.

Frequently Asked Questions about aem-init

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

FAQPage Schema
How do I auto-configure AEM settings in my config.yaml?

To auto-configure AEM settings, run the aem-init skill after dx-init. It detects your AEM project structure and automatically appends an aem section to your base .ai/config.yaml file to standardize DX governance.

What is the best way to set up the DX workflow for multi-repo AEM projects?

Setting up the DX workflow for multi-repo AEM projects requires appending an aem block to .ai/config.yaml. This skill detects component paths, frontend layouts, and brands to provide consistent context for downstream operations.

Can I re-run AEM component discovery and index updates without breaking my configuration?

Yes, you can re-run AEM component discovery safely. The skill validates re-run behavior to ensure all steps execute correctly, including component index updates, shared rule extensions, and Copilot integration notes.

Does aem-init work with existing .ai/config.yaml files or does it require a new one?

The skill works with existing .ai/config.yaml files by appending the aem section to the base configuration. It requires access to the local project structure and this configuration file to perform accurate detection and modification.

Why do I need to run dx-init before configuring AEM settings?

You need to run dx-init first because aem-init appends an aem section to the base .ai/config.yaml created during initialization. This ensures the DX workflow has the foundational configuration before AEM-specific settings are applied.

What limitations exist when detecting AEM project structure for component paths?

Detection of AEM project structure requires direct access to the local project directory and the .ai/config.yaml file. Without proper local project structure access, the skill cannot accurately detect component paths, frontend layouts, or brands.