skills.rest
adobe
adobeOFFICIAL
Explore all skills by this author →
WebsiteGitHub

best-practices

Catalogs reference modules for migrating AEM code to Cloud Service.

1|Updated Apr 14, 2026
Search Tags:#migration#patterns#best-practices#aem-cloud-service#htl#resource-resolver#scr-to-osgi-ds
One-click install
npx skills add https://github.com/adobe/aem-auth-demo --skill best-practices-adobe
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: best-practices
Source: https://github.com/adobe/aem-auth-demo/tree/main/.agents/skills/best-practices
Command: npx skills add https://github.com/adobe/aem-auth-demo --skill best-practices-adobe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams migrating AEM to Cloud Service need guardrails, references, and transformation modules to ensure Java/OSGi patterns, Asset Manager, replication, and HTL patterns comply with Cloud Service requirements and avoid deprecated APIs.

Core Features & Use Cases

  • Provides a centralized catalog of best-practice guidelines and pattern-reference modules for migrating AEM code to Cloud Service.
  • Documents prerequisites, migration patterns (SCR→DS, ResourceResolver, logging, asset API changes, replication, event handling, and HTL lint patterns), and transformation steps.
  • Serves as a single source of truth for automated tools and manual reviews during Cloud Service migrations.

Quick Start

Consult the best-practices to guide migration and cloud readiness checks before updating AEM components.

Frequently Asked Questions about best-practices

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

FAQPage Schema
How do I migrate AEM code to Cloud Service and ensure it complies with best practices?▼

To migrate AEM code to Cloud Service, consult the centralized catalog of best-practice guidelines and pattern-reference modules to ensure Java/OSGi patterns, Asset Manager, replication, and HTL patterns comply with Cloud Service requirements and avoid deprecated APIs.

What is the SCR to OSGi Declarative Services migration pattern for AEM Cloud Service?▼

The SCR to OSGi Declarative Services migration pattern involves transforming legacy SCR annotations into OSGi DS annotations to meet AEM Cloud Service prerequisites. The best-practices catalog provides reference modules to guide this specific transformation step.

Does AEM Cloud Service migration require updating ResourceResolver and asset API patterns?▼

Yes, AEM Cloud Service migration requires updating ResourceResolver and asset API patterns to avoid deprecated APIs. The best-practices catalog documents prerequisites and transformation steps for these specific Asset Manager changes.

How do I handle HTL lint and event handling patterns during an AEM Cloud Service migration?▼

To handle HTL lint and event handling patterns during an AEM Cloud Service migration, use the catalog of transformation and reference modules. These modules guide developers through automated references and manual reviews for HTL lint concerns and event handling compliance.

What are the limitations of using manual reviews for AEM Cloud Service code migration?▼

Manual reviews for AEM Cloud Service code migration rely on the aem-cloud-service prerequisites and best-practices resources as a single source of truth. While effective for ensuring compliance, they require careful cross-referencing with the catalog to avoid missing deprecated API usage.

Related Skills

Explore More Software Engineering Skills→
jnealey88jnealey88
12

check-compat

Audit WordPress and Gutenberg version compatibility across PHP plugins and block.json schemas.

Community
Advanced
adobeadobe

workflow-development

Develop custom AEM Workflow Java components with OSGi DS annotations.

Official
Advanced
JahiaJahia

jahia-dev-osgi-module

Define and enforce conventions for building Jahia OSGi/Java bundle modules.

Official
Advanced
valithedgevalithedge

migration

Orchestrate legacy AEM migration to AEM as a Cloud Service.

Community
Advanced