adobe__skills/README.md

Adobe Skills for AI Coding Agents

Repository of Adobe skills for AI coding agents.

Installation

Claude Code Plugins

# Add the Adobe Skills marketplace
/plugin marketplace add adobe/skills

# Install AEM Edge Delivery Services plugin (all 17 skills)
/plugin install aem-edge-delivery-services@adobe-skills

# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher) in one command
/plugin install aem-cloud-service@adobe-skills

# Install all AEM 6.5 LTS skills (workflow + dispatcher) in one command
/plugin install aem-6-5-lts@adobe-skills

Vercel Skills (npx skills)

# Install all AEM Edge Delivery Services skills
npx skills add https://github.com/adobe/skills/tree/main/skills/aem/edge-delivery-services --all

# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher) in one command
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service --all

# Install all AEM 6.5 LTS skills (workflow + dispatcher) in one command
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/6.5-lts --all

# Install for a single agent (pick ONE flavor only)
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service -a cursor -y
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/6.5-lts -a cursor -y

# Install specific skill(s)
npx skills add adobe/skills -s content-driven-development
npx skills add adobe/skills -s content-driven-development building-blocks testing-blocks

# List available skills
npx skills add adobe/skills --list
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service --list
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/6.5-lts --list

upskill (GitHub CLI Extension)

gh extension install trieloff/gh-upskill

# Install all AEM Edge Delivery Services skills
gh upskill adobe/skills --path skills/aem/edge-delivery-services --all

# Install all AEM as a Cloud Service skills (create-component + workflow + dispatcher)
gh upskill adobe/skills --path skills/aem/cloud-service --all

# Install all AEM 6.5 LTS skills (workflow + dispatcher)
gh upskill adobe/skills --path skills/aem/6.5-lts --all

# Install a specific skill
gh upskill adobe/skills --path skills/aem/edge-delivery-services --skill content-driven-development

# List available skills
gh upskill adobe/skills --path skills/aem/edge-delivery-services --list
gh upskill adobe/skills --path skills/aem/cloud-service --list
gh upskill adobe/skills --path skills/aem/6.5-lts --list

Available Skills

AEM Edge Delivery Services

This package provides three capability areas:

• Core development workflow skills
• Discovery and documentation lookup skills
• Migration and import workflow skills

See skills/aem/edge-delivery-services/skills/ for the current concrete skill set.

AEM as a Cloud Service — Create Component

The create-component skill creates complete AEM components following Adobe best practices for AEM Cloud Service and AEM 6.5. It covers:

• Component definition, dialog XML, and HTL template
• Sling Model and optional child item model (multifield)
• Unit tests for models and servlets
• Clientlibs (component and dialog)
• Optional Sling Servlet for dynamic content

See skills/aem/cloud-service/skills/create-component/ for the skill and its reference files.

AEM as a Cloud Service — Ensure AGENTS.md (bootstrap)

The ensure-agents-md skill is a bootstrap skill that runs first, before any other work. When a customer opens their AEM Cloud Service project and asks the agent anything, this skill checks whether AGENTS.md exists at the repo root. If missing, it:

• Reads root pom.xml to resolve the project name and discover actual modules
• Detects add-ons (CIF, Forms, SPA type, precompiled scripts)
• Generates a tailored AGENTS.md with only the modules that exist, correct frontend variant, conditional Dispatcher MCP section, and the right resource links
• Creates CLAUDE.md (@AGENTS.md) so Claude-based tools also discover the guidance

If AGENTS.md already exists it is never overwritten.

See skills/aem/cloud-service/skills/ensure-agents-md/ for the skill, template, and module catalog.

AEM Workflow

Workflow skills cover the full AEM Granite Workflow Engine lifecycle — from designing and implementing workflows to production debugging and incident triaging. Like Dispatcher, they are split by runtime flavor:

• skills/aem/cloud-service/skills/aem-workflow — Cloud Service variant (no JMX, Cloud Manager logs, pipeline deploy)
• skills/aem/6.5-lts/skills/aem-workflow — 6.5 LTS / AMS variant (JMX, Felix Console, direct log access)

Each flavor contains the same specialist sub-skills:

Sub-Skill	Purpose
workflow-model-design	Design workflow models, step types, OR/AND splits, variables
workflow-development	Implement WorkflowProcess steps, ParticipantStepChooser, OSGi services
workflow-triggering	Start workflows from UI, code, HTTP API, or Manage Publication
workflow-launchers	Configure automatic workflow launchers on JCR events
workflow-debugging	Debug stuck, failed, or stale workflows in production
workflow-triaging	Classify incidents, determine log patterns, Splunk queries
workflow-orchestrator	Full lifecycle orchestration across all sub-skills

AEM Dispatcher

Dispatcher skills are split by runtime flavor to avoid mode auto-detection and keep installation explicit. Install only one dispatcher flavor in a workspace (cloud-service or 6.5-lts).

Current dispatcher flavors:

• skills/aem/cloud-service/skills/dispatcher
• skills/aem/6.5-lts/skills/dispatcher

Each flavor contains parallel capability groups (workflow orchestration, config authoring, technical advisory, incident response, performance tuning, and security hardening). Shared advisory logic is centralized under each flavor's dispatcher/shared/references/ to reduce duplication and drift.

Repository Structure

skills/
\-- aem/
    |-- edge-delivery-services/
    |   |-- .claude-plugin/
    |   |   \-- plugin.json
    |   \-- skills/
    |       |-- content-driven-development/
    |       |-- building-blocks/
    |       \-- ...
    |-- cloud-service/
    |   |-- .claude-plugin/
    |   |   \-- plugin.json
    |   \-- skills/
    |       |-- ensure-agents-md/
    |       |   |-- SKILL.md          <-- bootstrap: creates AGENTS.md + CLAUDE.md if missing
    |       |   \-- references/
    |       |       |-- AGENTS.md.template
    |       |       \-- module-catalog.md
    |       |-- create-component/
    |       |   |-- SKILL.md          <-- discovered by npx skills
    |       |   |-- assets/
    |       |   |   \-- field-type-mappings.md
    |       |   \-- references/
    |       |       |-- aem-conventions.md
    |       |       |-- dialog-patterns.md
    |       |       |-- htl-patterns.md
    |       |       |-- model-patterns.md
    |       |       |-- java-standards.md
    |       |       |-- clientlib-patterns.md
    |       |       |-- extending-core-components.md
    |       |       |-- sling-servlet-standards.md
    |       |       |-- core-components.md
    |       |       |-- test-patterns.md
    |       |       |-- no-hallucination-rules.md
    |       |       \-- examples.md
    |       |-- aem-workflow/
    |       |   |-- SKILL.md          <-- discovered by npx skills (router)
    |       |   |-- workflow-model-design/
    |       |   |   |-- SKILL.md      <-- specialist (bundled inside aem-workflow)
    |       |   |   \-- references/
    |       |   |-- workflow-development/
    |       |   |-- workflow-triggering/
    |       |   |-- workflow-launchers/
    |       |   |-- workflow-debugging/
    |       |   |-- workflow-triaging/
    |       |   \-- workflow-orchestrator/
    |       \-- dispatcher/
    |           |-- SKILL.md          <-- discovered by npx skills (router)
    |           |-- config-authoring/
    |           |   |-- SKILL.md      <-- specialist (bundled inside dispatcher)
    |           |   \-- references/
    |           |-- technical-advisory/
    |           |-- incident-response/
    |           |-- performance-tuning/
    |           |-- security-hardening/
    |           \-- workflow-orchestrator/
    \-- 6.5-lts/
        |-- .claude-plugin/
        |   \-- plugin.json
        \-- skills/
            |-- aem-workflow/
            |   |-- SKILL.md          <-- discovered by npx skills (router)
            |   |-- workflow-model-design/
            |   |-- workflow-development/
            |   |-- workflow-triggering/
            |   |-- workflow-launchers/
            |   |-- workflow-debugging/
            |   |-- workflow-triaging/
            |   \-- workflow-orchestrator/
            |-- ensure-agents-md/
            \-- dispatcher/
                |-- SKILL.md          <-- discovered by npx skills (router)
                |-- config-authoring/
                |   |-- SKILL.md      <-- specialist (bundled inside dispatcher)
                |   \-- references/
                |-- technical-advisory/
                |-- incident-response/
                |-- performance-tuning/
                |-- security-hardening/
                \-- workflow-orchestrator/

Contributing

See CONTRIBUTING.md for guidelines on adding or updating skills.

Resources

• agentskills.io Specification
• Claude Code Plugins
• Vercel Skills
• upskill GitHub Extension

License

Apache 2.0 - see LICENSE for details.