Files
adobe__skills/.gitignore
Abhishek Garg 4c492792d8 feat: adding aem content distribution skill in AEMaaCS skills (#84)
* Add comprehensive AEM Cloud Service content distribution skills

Created a complete skill suite for AEM as a Cloud Service content distribution,
covering publishing workflows, Preview tier management, programmatic APIs,
troubleshooting, and orchestration.

Skills included:
- content-distribution (main orchestrator with intent routing)
- publish-content (Quick Publish, Manage Publication, Tree Activation, scheduling)
- preview-tier (Preview tier workflows, UAT testing, stakeholder review)
- distribution-api (JCR-based publishing, OSGi event handlers, bulk operations)
- troubleshoot-distribution (diagnostics for stuck content, CDN cache, Sling jobs)
- orchestrator (go-live preparation, incident response, CDN optimization)

Reference documentation:
- architecture.md (3-tier architecture, Sling Content Distribution, CDN)
- cloud-guardrails.md (rate limits, best practices, capacity planning)

Key features:
- 9 markdown files with 3,703 lines of comprehensive documentation
- 100% Cloud Service-specific (no 6.5 LTS content)
- Real-world examples with Java code and workflows
- Preview tier native support (Cloud Service exclusive feature)
- Automatic Sling Content Distribution (vs manual replication agents)
- Integrated Adobe CDN with auto-purge
- Based on official Adobe documentation

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Remove all migration-related content and fix broken references

Address PR review feedback:
- Remove migration workflow from orchestrator capabilities (README.md, SKILL.md)
- Remove migration use cases
- Delete entire "Migration from AEM 6.5 LTS" section from README
- Delete "Migration from 6.5 LTS Guardrails" section from cloud-guardrails.md
- Replace migration note with reference to separate migration skill
- Remove broken references to non-existent sling-distribution.md, cdn-integration.md, preview-tier.md files
- Add note that additional reference documentation will be added in future updates

All migration-related content removed per PR requirements.
Documentation now focuses solely on Cloud Service content distribution.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Correct AEM Cloud Service Replication API documentation

CRITICAL FIXES:
1. Replication API EXISTS in Cloud Service (not removed)
   - Corrected false claim that com.day.cq.replication.* is "REMOVED"
   - The Replicator interface, ReplicationOptions, ReplicationStatus all exist
   - Official Adobe Javadoc confirms API availability

2. Use official Replicator.replicate() method (not JCR properties)
   - Replaced undocumented JCR property approach with official API
   - Updated all code examples to use replicator.replicate()
   - Added proper OSGi service injection examples

3. Removed all migration-related content
   - Changed "Migrating large content trees" to "Publishing large content trees"
   - Changed "Site migration" to "Bulk site publishing"
   - Changed "Controlled content migration" to "Specific content deployment"
   - Removed reference to non-existent "migration skill"

4. Added Cloud Service capacity limits
   - Maximum 100 paths per replicate() call (recommended)
   - Absolute limit: 500 paths (throws ReplicationException)
   - Maximum 10MB content size per call
   - Recommend Tree Activation workflow for bulk operations

VERIFIED AGAINST:
- https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/operations/replication
- https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/com/day/cq/replication/package-summary.html
- https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/com/day/cq/replication/Replicator.html

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Rewrite content distribution skills with official APIs

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

**Previous issues:**
- Incorrectly claimed Replication API (com.day.cq.replication) was removed
- Showed manual JCR property manipulation instead of using Replicator service
- Referenced "Sling Content Distribution API" as developer-facing (it's internal)
- Mixed UI workflows with programmatic APIs
- Generic troubleshooting content with no unique value

**Changes made:**
- Deleted 7 files with incorrect/low-value content (3,349 lines)
- Created 2 new skills based on official APIs (2,154 lines):
  1. replication/SKILL.md - Official Replication API (com.day.cq.replication.Replicator)
  2. sling-distribution/SKILL.md - Distribution event monitoring (org.apache.sling.distribution.event)
- Rewrote README.md and SKILL.md with accurate architecture and examples

**Official documentation sources:**
- Replication API: https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/com/day/cq/replication/
- Sling Distribution: https://developer.adobe.com/experience-manager/reference-materials/cloud-service/javadoc/org/apache/sling/distribution/
- Adobe Guide: https://experienceleague.adobe.com/docs/experience-manager-cloud-service/content/operations/replication.html

**What's included:**
- Complete Replicator API usage (single/bulk publishing, Preview tier)
- ReplicationOptions for advanced configuration
- Distribution event handling (CREATED, QUEUED, DISTRIBUTED, DROPPED, IMPORTED)
- Rate limits and best practices (100 paths/call, 10MB max)
- Real code examples verified against official Javadoc
- Workflow integration patterns
- Service user configuration examples

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Add helper method implementations to code example

- Add getServiceResolver() implementation with ResourceResolverFactory
- Add isContentFragment() implementation
- Improves code example completeness for developers

* docs: Mark content-distribution skill as beta using PR #72 convention

Apply the three-mechanism beta skill convention:
- Add frontmatter status: beta field
- Add [BETA] prefix and warning to description
- Add blockquote beta notice in body

This follows the pattern documented in adobe/skills#72 for marking
skills that are under active development and need verification before
production use.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: align skill names with parent directory names

Address review feedback from @rombert - update skill name fields
to match parent directory names per agentskills.io specification:
- aem-content-distribution → content-distribution
- aem-replication-api → replication
- aem-sling-distribution → sling-distribution

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: move content-distribution skill from skills/ to plugins/ top-level directory

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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: add license field and remove disallowed status field from content-distribution skills

- Add license: Apache-2.0 to all 3 SKILL.md files (required by license-field CI check)
- Remove status: beta from content-distribution/SKILL.md (not an allowed frontmatter field per validate CI check)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: removing depricating apis

---------

Co-authored-by: Abhishek Garg <abhigarg+adobe@adobe.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-04-23 14:17:03 +05:30

21 lines
167 B
Plaintext

# Dependencies
node_modules/
# OS files
.DS_Store
# Editor files
*.swp
*.swo
*~
# Temporary files
drafts/tmp/
# Release artifacts
*.skill
dist/
# OMC state
.omc/