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/workflow-triggering
development
VerifiedTrustedCommunity
Start AEM Workflows on AEM as a Cloud Service using all available triggering mechanisms. Use when starting workflows manually via the Timeline UI, programmatically via WorkflowSession.startWorkflow(), via the HTTP Workflow API, through Manage Publication, or passing initial metadata and payload to a workflow instance.
125SKILL.mdUpdated Apr 28, 2026
adobe/aem-workflow
development
VerifiedTrustedCommunity
Single entry point for all AEM as a Cloud Service Workflow skills. Covers workflow model design, custom process step and participant chooser development, launcher configuration, workflow triggering, and production support including debugging stuck/failed workflows, triaging incidents with Cloud Manager logs, thread pool analysis, and Sling Job diagnostics for the Granite Workflow Engine.
125SKILL.mdUpdated Apr 25, 2026
adobe/workflow-development
development
VerifiedTrustedCommunity
[BETA] Implement custom AEM Workflow Java components on AEM as a Cloud Service. This skill is in beta. Verify all outputs before applying them to production projects. Use when writing WorkflowProcess steps, ParticipantStepChooser implementations, registering services via OSGi DS R6 annotations, reading step arguments from MetaDataMap, accessing JCR payload via WorkflowSession adapter, reading and writing workflow metadata and variables, and handling errors with WorkflowException for retry behavior.
122SKILL.mdUpdated Apr 28, 2026
adobe/workflow-triggering
development
VerifiedTrustedCommunity
Start AEM Workflows on AEM 6.5 LTS using all available triggering mechanisms. Use when starting workflows manually via the Timeline UI, programmatically via WorkflowSession.startWorkflow(), via the HTTP Workflow API, through Manage Publication, through replication triggers, or passing initial metadata and payload to a workflow instance.
122SKILL.mdUpdated Apr 24, 2026