aem-doctor

Validate AEM components, OSGi configurations, dispatcher rules, and content structure.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill checks the health of AEM project infrastructure by verifying component definitions, OSGi configurations, dispatcher rules, and content structure to identify drift or misconfigurations.

Core Features & Use Cases

  • Validation of component definitions (.content.xml) across the AEM project
  • OSGi configuration integrity and dispatcher rule sanity checks
  • Drift detection and diagnostic reporting to surface misconfigurations after changes
  • Read-only checks to avoid unintended modifications

Quick Start

Run the aem-doctor to scan local files and the AEM instance state as needed, then review the generated health report.

Frequently Asked Questions about aem-doctor

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

FAQPage Schema
How do I detect configuration drift in AEM dispatcher and OSGi settings?

AEM infrastructure validation checks component definitions, OSGi configurations, dispatcher rules, and content structure to detect drift. It cross-references local repository files against expected state and optionally validates live AEM instances to surface missing definitions.

Can I run read-only validation checks against a live AEM instance?

AEM infrastructure validation supports read-only checks against a live AEM instance. It diagnoses OSGi configurations and dispatcher rules without applying unintended modifications, safely detecting misconfigurations and structural gaps.

How do I validate AEM component definitions and content structure?

Validate AEM component definitions by reading .content.xml files and cross-referencing a component index when present. This identifies missing definitions and structural gaps in content organization, outputting a structured health report.

What is needed to diagnose AEM infrastructure health at a glance?

Diagnosing AEM infrastructure health requires local repository files and a configuration file at .ai/config.yaml. It validates OSGi and dispatcher rules, outputting a structured, human-accessible health report.

What limitations exist when checking AEM OSGi configuration integrity?

A limitation of checking AEM OSGi configuration integrity is that checks are strictly read-only. This prevents the tool from auto-remedying detected configuration drift or applying structural fixes to dispatcher rules.