feat: adding aem content distribution skill in AEMaaCS skills

[abhishekgarg18]

AEM as a Cloud Service Content Distribution Skills

Complete rewrite of content distribution skills based on official AEM Cloud Service Javadoc and Adobe documentation.

What Changed

Previous Issues

• ❌ Incorrectly claimed Replication API (com.day.cq.replication) was "removed" from Cloud Service
• ❌ Showed manual JCR property manipulation instead of using official Replicator service
• ❌ Referenced "Sling Content Distribution API" as a developer-facing API (it's an internal mechanism)
• ❌ Mixed UI workflows with programmatic APIs
• ❌ Generic troubleshooting content with no unique value

New Implementation

Deleted: 7 files, 3,349 lines of incorrect/low-value content
Created: 4 files, 2,154 lines of official API-based content

✅ Two focused skills based on official APIs:

1. Replication API (replication/SKILL.md - 708 lines)

Official com.day.cq.replication.Replicator API for programmatic publishing:

• Single and bulk publishing with proper rate limits (100/500 paths, 10MB max)
• Publishing to Preview vs Publish tiers with agent filtering
• ReplicationOptions for advanced configuration (synchronous mode, versioning, listeners)
• ReplicationStatus for checking publication state
• ReplicationActionType enum (ACTIVATE, DEACTIVATE, DELETE, TEST)
• Workflow process step integration
• Permission validation with checkPermission()
• Service user configuration examples
• Complete working code examples verified against Javadoc

2. Sling Distribution Events (sling-distribution/SKILL.md - 738 lines)

Distribution lifecycle event monitoring via org.apache.sling.distribution.event:

• Event topics: AGENT_PACKAGE_CREATED, QUEUED, DISTRIBUTED, DROPPED, IMPORTER_PACKAGE_IMPORTED
• Event properties: package ID, paths, distribution type, component info, timestamps
• OSGi event handler examples for each lifecycle stage
• Practical use cases:
  • Failure alerting (monitor DROPPED events)
  • CDN cache warming (on IMPORTED events)
  • Analytics tracking (duration, success rates)
  • Audit logging (complete distribution history)
  • Slack/email notifications
• Queue depth monitoring patterns
• Distribution request types: ADD, DELETE, PULL, INVALIDATE, TEST

3. Documentation

• README.md (367 lines) - Architecture diagrams, how APIs work together, common patterns, quick reference
• SKILL.md (341 lines) - Parent skill with routing logic, decision guide, integration examples

Official Documentation Sources

Every code example and API usage verified against:

• Replication API Javadoc: https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/com/day/cq/replication/package-summary.html
• Sling Distribution Javadoc: https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/org/apache/sling/distribution/package-summary.html
• Adobe Replication Guide: https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/operations/replication.html
• Sling Distribution Docs: https://sling.apache.org/documentation/bundles/content-distribution.html

Key Corrections

1. Replication API exists and should be used - Previous version incorrectly claimed it was removed. The official way to publish content is replicator.replicate(session, ReplicationActionType.ACTIVATE, path)

2. No manual JCR property manipulation - Removed incorrect examples that manually set cq:lastReplicationAction properties. Use the Replicator service instead.

3. Sling Distribution clarified - Correctly explained as the underlying transport mechanism (Adobe Developer pipeline service), not a direct developer API. Developers use Replicator API; Sling Distribution fires events during the process.

4. Rate limits documented - Official constraints: 100 paths (transactional guarantee), 500 hard limit, 10MB payload size

Architecture

┌─────────────────────────────────────────┐
│ Your Code: Replication API              │
│ replicator.replicate(...)               │
└──────────────────┬──────────────────────┘
                   ↓
┌─────────────────────────────────────────┐
│ Sling Distribution (Transport)          │
│ - Package creation [EVENT: CREATED]     │
│ - Queueing [EVENT: QUEUED]              │
│ - Distribution [EVENT: DISTRIBUTED]     │
│ - Adobe Developer Pipeline              │
│ - Import [EVENT: IMPORTED]              │
└──────────────────┬──────────────────────┘
                   ↓
         Content live on Publish/Preview

Verification

✅ All code examples are working Java code
✅ All API references verified against official Cloud Service Javadoc
✅ All class names, method signatures, and interfaces match current API
✅ Rate limits and constraints from official documentation
✅ Best practices aligned with Adobe recommendations
✅ Skill names align with parent directory names per agentskills.io specification

Location

skills/aem/cloud-service/skills/content-distribution/

---

Previous PR: #67 (closed - was from fork, CI didn't run)
Review approvals: @trieloff, @rombert

🤖 Generated with Claude Code

[rombert]

Following #76 the top-level directory is plugins, not skills.