* feat(da-auth): add da-auth skill and surface DA auth in CDD workflow
Adds a dedicated da-auth sub-skill for obtaining a valid Adobe IMS
token before making DA Admin API calls. Updates content-driven-development
and building-blocks to reference it at the right points in their workflows.
Motivation: agents working outside the create-site onboarding flow had
no guidance on DA authentication, requiring manual hand-holding every
time content needed to be pushed or a preview triggered.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix(da-auth): remove CMS phrasing from DA references
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* 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>