Files
Akanksha Jain 0bb514abf0 feat(aem-workflow): improve 6.5 LTS workflow-triaging skill (#284)
* feat(aem-workflow): improve 6.5 LTS workflow-triaging skill

Verify the 6.5 LTS workflow-triaging skill against the running instance and
align it with the merged cloud-service twin and the sibling workflow-debugging skill:

- Fix References: the old section pointed to files that do not exist in the
  repo; repoint to workflow-debugging/SKILL.md, workflow-debugging/reference.md,
  the 65-lts guardrails reference, and the intent router.
- Add a Safety & security guardrails section; split Step 4 JMX into read-only
  diagnostics vs destructive operations, with dry-run-first and change-control
  guidance, least-privilege console access, and log/PII handling rules.
- Add the WorkItem vs TaskManager callout (/var/workflow/instances vs
  /var/taskmanagement/tasks) to prevent diagnosing the wrong backend.
- Add the workflow_auto_advance_failure symptom and the RejectedExecutionException,
  transient-retries-exhausted, and already-finished log patterns.
- Add Audience and Dependencies sections and an AEMaaCS cross-variant guard.

JMX MBean/operations, storage paths, and console paths verified on AEM 6.5 LTS.

* fix(aem-workflow): genericize Splunk index and clarify JMX MBean lookup in 6.5 LTS triaging

- Replace the fabricated 'index=aem sourcetype=aem:error' examples with an
  explicit index=<your_aem_index> placeholder and note that index/sourcetype/field
  names are environment-specific with no fixed value; avoids shipping a
  hardcoded or internal index name in customer-facing content.
- Add a Step 4 pointer to the exact Maintenance MBean URL, noting the operations
  render below the attribute block and are distinct from the workflow.core.*
  listener MBeans that also match a 'workflow' filter.

Operations (countStaleWorkflows/countRunningWorkflows/returnFailedWorkflowCount and
the rest) reconfirmed OOTB on AEM 6.5.1.LTS via the live Maintenance MBean.

* fix(aem-workflow): make 6.5 LTS triaging JMX note agent-actionable

The MBean-lookup note gave human-UI guidance ('scroll past the attribute
block'), which the skill's actual consumer -- an LLM agent with no screen or
mouse -- cannot act on. Reframe it as actor-agnostic facts: match the exact
type=Maintenance object name (not a 'workflow' substring, which also matches
the workflow.core.* listener MBeans), and treat the table entries as invokable
operations with an optional model parameter rather than readable attributes.

---------

Co-authored-by: akanjain <akanjain@adobe.com>
2026-08-20 16:30:19 +05:30
..

AEM 6.5 LTS Plugin

Skills for developing and operating AEM 6.5 LTS and Adobe Managed Services (AMS) projects — Dispatcher configuration, workflows, replication, and project bootstrap.


Installation

Claude Code:

/plugin marketplace add adobe/skills
/plugin install aem-6-5-lts@adobe-skills

Skills

Bootstrap

Skill Description Try it
ensure-agents-md Auto-generates AGENTS.md and CLAUDE.md for AEM 6.5 LTS projects when missing — tailored to discovered modules, add-ons, and Dispatcher layout. Runs first, before any other work. Set up my AEM 6.5 project for AI agents

Dispatcher

Config authoring, advisory, performance, security, and incident response. Requires Dispatcher MCP (AEM_DEPLOYMENT_MODE=ams).

Skill Description Try it
config-authoring Create, modify, review, and harden Dispatcher config files (.any, vhost, rewrite, cache, filter) for AEM 6.5 LTS and AMS Add a new vhost for my AMS site
technical-advisory Conceptual guidance on statfileslevel, filter rules, URL decomposition, cache invalidation, rewrite behavior, and security headers Explain statfileslevel for my AMS setup
incident-response Investigate runtime incidents, failures, and cache anomalies on AMS Dispatcher My pages are returning 403 on the AMS dispatcher
performance-tuning Optimize Dispatcher cache efficiency, latency, and throughput for AMS environments Tune my AMS dispatcher cache
security-hardening Security audits, threat models, exposure control, and header hardening for AMS Dispatcher Harden my AMS dispatcher security headers
workflow-orchestrator Orchestrate complete Dispatcher lifecycle from design through validation and incident troubleshooting Walk me through AMS dispatcher setup end-to-end

Workflow

Granite Workflow Engine lifecycle with JMX, Felix Console, and direct log access.

Skill Description Try it
workflow-model-design Design workflow models — step types, variables, OR/AND splits Design an approval workflow with OR split
workflow-development Implement custom WorkflowProcess steps, ParticipantStepChooser, OSGi service registration Create a custom workflow process step
workflow-triggering Start workflows via Timeline UI, WorkflowSession API, HTTP API, Manage Publication, or replication triggers How do I trigger a workflow on content activation?
workflow-launchers Configure Workflow Launchers that auto-start workflows on JCR content changes Set up a launcher for asset uploads
workflow-debugging Debug stuck workflows, failed steps, missing Inbox tasks, thread pool exhaustion, queue backlogs — with JMX and direct log access My workflow is stuck — help debug
workflow-triaging Classify workflow incidents, gather JMX/Splunk data, and map to runbooks Triage this workflow failure
workflow-orchestrator End-to-end workflow lifecycle orchestration across all sub-skills Build a complete content approval workflow

Replication

Content distribution lifecycle from agent configuration to troubleshooting.

Skill Description Try it
configure-replication-agent Configure replication agents for publishing, dispatcher flush, and reverse replication Set up a dispatcher flush agent
replicate-content Activate and deactivate content using UI, workflows, and package manager How do I activate a page tree?
replication-api Use the Replication API programmatically in custom code — 57 Java examples for OSGi services, servlets, and workflow steps Publish content programmatically from a servlet
troubleshoot-replication Diagnose and fix blocked queues, connectivity failures, and distribution problems — 12+ troubleshooting scenarios My replication queue is blocked
replication-orchestrator End-to-end replication lifecycle orchestration across all sub-skills — new environment setup, production incidents, performance optimization, and migration preparation Set up replication for a new AEM 6.5 environment end-to-end