workflow-development
Implement custom AEM Workflow Java components on AEM as a Cloud Service. 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.
80
100%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly defines a narrow, well-scoped domain (AEM Workflow Java components) with highly specific actions and trigger terms. It follows the recommended pattern with an explicit 'Use when...' clause and uses third-person voice throughout. The technical specificity ensures minimal conflict risk with other skills while providing strong signal for when to select it.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description lists multiple specific concrete actions: writing WorkflowProcess steps, ParticipantStepChooser implementations, registering services via OSGi DS R6 annotations, reading step arguments from MetaDataMap, accessing JCR payload via WorkflowSession adapter, reading/writing workflow metadata and variables, and handling errors with WorkflowException. | 3 / 3 |
Completeness | Clearly answers both 'what' (implement custom AEM Workflow Java components) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios like writing WorkflowProcess steps, registering OSGi services, reading step arguments, etc. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms a developer would use: 'AEM', 'Workflow', 'WorkflowProcess', 'ParticipantStepChooser', 'OSGi', 'MetaDataMap', 'WorkflowSession', 'JCR payload', 'WorkflowException', 'AEM as a Cloud Service'. These are precisely the terms a developer working in this domain would mention. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a very clear niche: AEM as a Cloud Service workflow Java components. The specific technology stack (AEM, OSGi DS R6, JCR, WorkflowSession) and use cases make it extremely unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that is concise, highly actionable, and well-structured. It provides two complete, executable Java templates covering the primary use cases, a clear development workflow with verification steps, specific guardrails for common pitfalls, and well-organized references for deeper content. The content respects Claude's intelligence while providing exactly the domain-specific knowledge needed for AEM workflow development.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It assumes Claude knows Java, OSGi, and AEM concepts without explaining them. Every section serves a clear purpose — templates are executable, guardrails are specific, and there's no padding or unnecessary explanation. | 3 / 3 |
Actionability | Both templates are fully executable Java classes with correct annotations, method signatures, and realistic inline comments showing how to read arguments, access payloads, and handle errors. The guardrails section provides specific, concrete constraints (e.g., never use loginAdministrative, don't call Session.save() on the workflow session). | 3 / 3 |
Workflow Clarity | The checklist-style workflow clearly sequences the development process from identifying step type through deployment verification. Step 7 explicitly covers error handling/retry behavior via WorkflowException, and step 8 includes a verification checkpoint. The templates themselves embed the workflow steps as numbered comments. | 3 / 3 |
Progressive Disclosure | The SKILL.md provides a concise overview with executable templates inline, then clearly signals five one-level-deep references for detailed patterns, API reference, and guardrails. The references are well-organized by topic with descriptive labels. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- adobe/skills
- Commit
e23271f
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.