adobe/aem-replication
plugins/aem/6.5-lts/skills/aem-replication/SKILL.md
Single entry point for all AEM 6.5 LTS Replication skills. Covers configuring replication agents, activating/deactivating content, using the Replication API programmatically, and troubleshooting distribution issues for Adobe Experience Manager 6.5 LTS.
$ install --global
skillsauthnpx skillsauth add adobe/skills aem-replicationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 20, 2026, 3:56 AM295.2s14 files scanned
SKILL.md
- name:
- aem-replication
- description:
- |
- license:
- Apache-2.0
- compatibility:
- Requires AEM 6.5 LTS or Adobe Managed Services (AMS). NOT compatible with AEM as a Cloud Service (use Sling Distribution API instead).
- version:
- 1.0
- aem_version:
- 6.5 LTS
AEM 6.5 LTS Replication
Route user requests to the appropriate specialist skill based on intent.
Intent Router
| User Intent | Skill | Path | |---|---|---| | Configure replication agents (default, dispatcher flush, reverse replication) | Configure Replication Agent | configure-replication-agent/SKILL.md | | Activate or deactivate content using UI or workflows | Replicate Content | replicate-content/SKILL.md | | Use Replication API programmatically in custom code | Replication API | replication-api/SKILL.md | | Diagnose blocked queues, connectivity issues, or distribution problems | Troubleshoot Replication | troubleshoot-replication/SKILL.md | | End-to-end workflows: new environment setup, incident response, performance optimization | Replication Orchestrator | replication-orchestrator/SKILL.md |
How to Use
- Match the user's request to one row in the Intent Router table above.
- Read the linked SKILL.md for that specialist skill.
- Follow the workflow and guidance defined in that skill.
- For complex scenarios spanning multiple skills (e.g., configure agent then troubleshoot), start with the primary intent and cross-reference as needed.
Skill Overview
Configure Replication Agent
Set up and configure replication agents for:
- Default agents: Author to Publish content distribution
- Dispatcher Flush agents: Cache invalidation
- Reverse replication: Publish to Author user-generated content flow
- Multiple publish instances: Load balancing and high availability
When to use: First-time setup, adding new publish instances, reconfiguring agents
Replicate Content
Activate and deactivate content through:
- Quick Publish: Simple one-click activation
- Manage Publication: Advanced scheduling and approval workflows
- Tree Activation: Hierarchical bulk publishing
- Package Manager: Specific content set distribution
- Workflows: Approval-based publishing
- Scheduled Activation: Time-based content publishing
When to use: Publishing pages, assets, or DAM content; unpublishing content
Replication API
Programmatic replication using official AEM 6.5 LTS public APIs:
- Replicator interface: Core replication methods
- ReplicationOptions: Configure synchronous/asynchronous, agent filtering
- ReplicationStatus: Query replication state
- AgentManager, ReplicationQueue, ReplicationListener: Advanced queue management and monitoring
When to use: Custom code integration, bulk operations, workflow process steps, servlets
Troubleshoot Replication
Diagnose and fix common issues:
- Blocked queues: FIFO queue failures
- Connection errors: Network, authentication, SSL issues
- Content not appearing: Dispatcher cache, permissions
- Agent configuration: URI, credentials, triggers
- Event queue issues: Stuck replication jobs
When to use: Replication failures, performance issues, content not distributing
Replication Orchestrator
Coordinates end-to-end replication workflows spanning multiple sub-skills:
- New Environment Setup: Configure agents → Test replication → Troubleshoot
- Production Incident Response: Diagnose → Fix → Verify
- Performance Optimization: Monitor → Tune → Validate
- Migration Preparation: Audit → Plan → Execute
When to use: Multi-step scenarios requiring coordination across configure, replicate, API, and troubleshoot skills
Common Workflows
First-Time Setup
- Use Configure Replication Agent to set up default agent
- Use Replicate Content to test with a sample page
- If issues occur, use Troubleshoot Replication
Production Operations
- Use Replicate Content for day-to-day publishing
- Use Replication API for automated/bulk operations
- Use Troubleshoot Replication when issues arise
Advanced Integration
- Use Replication API to understand available methods
- Use Configure Replication Agent to understand agent configuration
- Use Troubleshoot Replication for debugging custom replication code
Foundation References
Shared reference materials used across all replication skills:
- Agent Types: Default, Dispatcher Flush, Reverse, and Static agents
- Queue Mechanics: FIFO processing, retry logic, queue management
- AEM 6.5 LTS Guardrails: Service users, timeouts, batch limits, best practices
- API Quick Reference: Replicator, ReplicationOptions, ReplicationStatus methods
Official Documentation
All skills reference official Adobe AEM 6.5 LTS documentation:
- Replication Documentation
- Replication Troubleshooting
- Replication API JavaDoc
Related Skills
- AEM Workflow: Integrate replication with approval workflows
- Dispatcher: Configure Dispatcher Flush agents for cache invalidation
Migration to AEM as a Cloud Service
AEM as a Cloud Service uses the Sling Distribution API instead of replication agents. If planning migration:
- Review Cloud Service Distribution Documentation
- For code migration patterns, see
skills/aem/cloud-service/skills/best-practices/references/replication.md - Avoid agent-specific coupling (filter by agent ID) to reduce migration complexity
Related Skills
adobe/run-workflow
tools
VerifiedTrustedCommunity
Use the run-workflow MCP to discover, compose, execute, publish, and save Adobe Firefly workflows. TRIGGER when: user asks what actions are available, what the MCP can do, how to process images/video/3D via workflow, wants to build/run/save/publish a workflow, OR pastes any workflow/batch/execution ID. BARE ID (UUID/workflowId/batchId) = INSPECT ONLY — call inspect_run, NEVER run_workflow_submit. ALWAYS call list_actions first for capability/discovery questions. DO NOT TRIGGER for direct Firefly API calls without MCP (use firefly-api-specs).
150SKILL.mdUpdated Jul 28, 2026
adobe/run-featured-workflow
tools
VerifiedTrustedCommunity
Run predefined featured workflows via run-workflow MCP. TRIGGER when user names a featured workflow (retargeting, banners at scale, localization, packaging, banner advertising, etc.) or asks to run a known marketing/production workflow. Requires run-workflow MCP. ALWAYS call get_featured_workflow before compose_workflow. DO NOT TRIGGER for custom one-off workflows with no named template — use run-workflow skill.
150SKILL.mdUpdated Jul 28, 2026
adobe/commerce-app-migrate
tools
VerifiedTrustedCommunity
Migrate an Adobe Commerce App Builder project from the Integration Starter Kit or Checkout Starter Kit to the new App Management approach. Run from the root of the App Builder project to be migrated. Pass --auto to skip confirmation prompts (suitable for CI or batch use) — auto mode prints a summary of all Q&A questions answered with their defaults. Pass --doc-scan-only to scan README.md and env.dist for outdated content without modifying any files. Use when the user wants to migrate an App Builder project from the Integration Starter Kit or Checkout Starter Kit to the App Management approach, or mentions upgrading their Adobe Commerce extension architecture.
150SKILL.mdUpdated Jul 24, 2026
adobe/commerce-app-webhooks
development
VerifiedTrustedCommunity
Add or modify webhook interceptors in an Adobe Commerce app. Use when the user wants to intercept Commerce operations to validate input, append data, or modify behavior — before or after execution. Requires a base app initialized with commerce-app-init.
150SKILL.mdUpdated Jul 24, 2026