Agent skill

Workflow Model Design

by adobe in adobe/skills

Design and create AEM Workflow models on AEM as a Cloud Service.

Apache-2.0Auto-check passed

Install Workflow Model Design

skills CLI
$ npx skills add adobe/skills --skill workflow-model-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install adobe/skills workflow-model-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/adobe/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/aem/cloud-service/skills/aem-workflow/workflow-model-design .claude/skills/workflow-model-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workflow-model-design
GitHub stars
195
Token cost
~1.7k tokens
SKILL.md length
608 words
Files
10 (incl. references)
Skills in repo
105
Repo updated
First seen
Licence
Apache-2.0

At a glance

Design and create AEM Workflow models on AEM as a Cloud Service.

  • Works in 5 steps: Place model XML at:… → Add to ui.content package with… → Deploy via Cloud Manager pipeline → …
  • Creating workflow models via the Workflow Model Editor
  • SKILL.md covers Audience, Variant Scope, Dependencies and Workflow, plus 5 more sections
  • Calls mvn

What it does

Workflow Model Design is an agent skill from adobe/skills. Design and create AEM Workflow models on AEM as a Cloud Service. Use when creating workflow models via the Workflow Model Editor or content package XML, defining step types (PROCESS, PARTICIPANT, DYNAMICPARTICIPANT, ORSPLIT, ANDSPLIT), configuring step properties, declaring workflow variables, and deploying models through the Cloud Manager pipeline.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/workflow-foundation/README.md`, `references/workflow-foundation/api-reference.md` and `references/workflow-foundation/architecture-overview.md`).

It works with Adobe Experience Manager. The repository describes itself as: Adobe Skills for Agents. The licence is Apache-2.0.

When your agent uses it

  • Creating workflow models via the Workflow Model Editor
  • Content package XML
  • Defining step types (PROCESS
  • DYNAMICPARTICIPANT

Example prompts

  • “/workflow-model-design”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Place model XML at: conf/global/settings/workflow/models//.content.xml (the flow/parsys design-time format — not jcr:content/model/)
  2. Add to ui.content package with filter.xml entry mode="merge"
  3. Deploy via Cloud Manager pipeline
  4. Open Tools → Workflow → Models → select model → Edit → Sync
  5. Verify the model appears in /var/workflow/models/ via CRX/DE and all steps render on the canvas

What it can do on your machine

Read from SKILL.md and the folder at commit cbc9952. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • mvn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workflow Model Design loads about 1.7k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 94 tokens; SKILL.md has 608 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from adobe/skills at commit cbc9952, republished under its Apache-2.0 licence (© adobe). 608 words, ~1,734 tokens.

Download SKILL.mdSave it as .claude/skills/workflow-model-design/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
workflow-model-design
description
Design and create AEM Workflow models on AEM as a Cloud Service. Use when creating workflow models via the Workflow Model Editor or content package XML, defining step types (PROCESS, PARTICIPANT, DYNAMIC_PARTICIPANT, OR_SPLIT, AND_SPLIT), configuring step properties, declaring workflow variables, and deploying models through the Cloud Manager pipeline.
license
Apache-2.0

Workflow Model Design (Cloud Service)

Design workflow models for AEM as a Cloud Service: step structure, transitions, OR/AND splits, variables, and model XML deployment.

Audience

Developers (and the IDE LLM acting on their behalf) authoring AEM workflow models for AEM as a Cloud Service — designing the step graph, splits, joins, transitions, and the model XML that ships through the Cloud Manager pipeline.

Variant Scope

  • AEM as a Cloud Service only.
  • Models are stored at /conf/global/settings/workflow/models/. Do not write to /libs or /etc — /libs is immutable and /etc/workflow/models/ is the legacy 6.5 path, deprecated on AEMaaCS.
  • Deploy via Cloud Manager pipeline; design-time → runtime sync is required after deploy (Tools → Workflow → Models → Sync).
  • Not for AEM 6.5 LTS. If the target is 6.5 LTS, stop and use the 6.5-lts variant of this skill — /etc/workflow/models/ legacy auto-deploy and mvn install -PautoInstallPackage deploys documented there do not apply on AEMaaCS.

Dependencies

  • workflow-foundation references (architecture, API, JCR paths, Cloud Service guardrails) — load alongside.
  • workflow-development — every PROCESS step in the model needs a WorkflowProcess (or process.label) registered as an OSGi service. Model XML and Java code are co-authored.
  • workflow-launchers — when a launcher routes content into the model, see launcher-side guardrails.

Workflow

text
Model Design Progress
- [ ] 1) Clarify the workflow purpose: what triggers it, what steps are needed, who approves
- [ ] 2) Map out steps: PROCESS (auto), PARTICIPANT (human), OR_SPLIT (decision), AND_SPLIT (parallel)
- [ ] 3) Decide payload type: single JCR_PATH page/asset, or multi-page via workflow package
- [ ] 4) Identify workflow variables needed for inter-step data passing
- [ ] 5) Design model XML: flow/parsys layer with correct nt:unstructured step components and sling:resourceType per step
- [ ] 6) Add filter.xml entry with mode="merge" for the model path
- [ ] 7) Deploy via Cloud Manager pipeline
- [ ] 8) Open the model in Tools → Workflow → Models → Edit → Sync; verify the model appears in /var/workflow/models/ and all steps render on the editor canvas
- [ ] 9) Start a test workflow instance; confirm it runs to completion

Output Contract

Generate only these files for a /conf-based model:

FileNode typePurpose
jcr_root/conf/.../models/<id>/.content.xmlcq:PageModel root page
jcr_root/conf/.../models/<id>/jcr:content/.content.xmlcq:PageContentTitle, template, resourceType
jcr_root/conf/.../models/<id>/jcr:content/flow/.content.xmlnt:unstructured + parsysStep nodes

Never generate — hard stops:

  • ❌ Any file under jcr_root/var/ — AEM Sync writes /var/workflow/models/ automatically after you click Sync in the editor. Never ship /var content in a content package.
  • ❌ A model/ directory inside jcr:content/ at the /conf path — a cq:WorkflowModel node with <nodes> and <transitions> is the runtime format. It must never appear under /conf. The Workflow Model Editor cannot open a model that contains it.
  • ❌ <filter root="/var/workflow/models/..."/> in filter.xml — /var is never a package filter target. The only filter entry needed is the /conf path.
  • ❌ Any path under /etc/workflow/models/ — deprecated and unsupported on AEM as a Cloud Service.

filter.xml — correct entry:

xml
<filter root="/conf/global/settings/workflow/models/my-workflow" mode="merge"/>

Node Types Quick Reference

TypePurposeKey metaData property
STARTEntry point—
ENDTerminal—
PROCESSAuto-executed Java stepPROCESS = FQCN or process.label
PARTICIPANTHuman task (static assignee)PARTICIPANT = principal name
DYNAMIC_PARTICIPANTHuman task (runtime assignee)DYNAMIC_PARTICIPANT = chooser.label
OR_SPLITOne branch selected by ruleTransition rule = ECMAScript (Rhino)
AND_SPLITAll branches execute in parallel—
AND_JOINWait for all parallel branches—
EXTERNAL_PROCESSPoll an external systemEXTERNAL_PROCESS = FQCN
Show full SKILL.md (217 more words)Show less

Default Path Rule

Unless the user explicitly names a specific AEM site, always generate models at /conf/global/settings/workflow/models/<id>. Do not infer a site-scoped path (e.g., /conf/wknd/…) from conversational context such as "for the WKND site" or "install on the WKND instance." Workflow models are not site-scoped by default — they are global resources. Only use /conf/<site>/settings/workflow/models/<id> when the user explicitly states that the model should be scoped to a specific site.

Cloud Service Deployment

  1. Place model XML at: conf/global/settings/workflow/models/<name>/.content.xml (the flow/parsys design-time format — not jcr:content/model/)
  2. Add to ui.content package with filter.xml entry mode="merge"
  3. Deploy via Cloud Manager pipeline
  4. Open Tools → Workflow → Models → select model → Edit → Sync
  5. Verify the model appears in /var/workflow/models/<name> via CRX/DE and all steps render on the canvas

Design-time vs runtime paths: /conf/global/settings/workflow/models/ stores the editor's flow/parsys format — this is what you author and deploy. Steps are nt:unstructured nodes with sling:resourceType; no cq:WorkflowNode or cq:WorkflowTransition nodes appear here. /var/workflow/models/ holds the runtime copy generated by Sync — it uses cq:WorkflowModel, cq:WorkflowNode, and cq:WorkflowTransition. Never write cq:WorkflowModel nodes to the /conf path, and never hand-author /var content — AEM manages the runtime layer entirely via Sync.

References

© adobe, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in plugins/aem/cloud-service/skills/aem-workflow/workflow-model-design of adobe/skills.

  • SKILL.md
  • references/workflow-foundation/README.md
  • references/workflow-foundation/api-reference.md
  • references/workflow-foundation/architecture-overview.md
  • references/workflow-foundation/cloud-service-guardrails.md
  • references/workflow-foundation/jcr-paths-reference.md
  • references/workflow-foundation/quick-start-guide.md
  • references/workflow-model-design/model-design-patterns.md
  • references/workflow-model-design/model-xml-reference.md
  • references/workflow-model-design/step-types-catalog.md

Open the folder on GitHubat commit cbc9952

Compare with similar skills

Workflow Model Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workflow Model Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflow Model Design this skilladobe/skills195—~1.7kAutomated safety check: PassApache-2.0
Sanity Migrationsanity-io/agent-toolkit187—~1.4kAutomated safety check: PassMIT
Content Management Systemsgithub/awesome-copilot40k1 repos~1.3kAutomated safety check: PassMIT
App Builder UI ScaffolderNeverSight/learn-skills.dev2161 repos~2.2kAutomated safety check: PassApache-2.0
Authoring Analysismajiayu000/claude-skill-registry6662 repos~3.1kAutomated safety check: PassMIT
Block Inventorymajiayu000/claude-skill-registry6661 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Sanity Migration

    sanity-io/agent-toolkit

    Official

    Plans, implements, and reviews migrations from other CMSes and content systems into Sanity.

    187 GitHub stars~1.4k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Content Management Systems

    github/awesome-copilot

    Official

    Workflow for building and modifying content management systems across WordPress, Shopify, Wix, Squarespace, Drupal, WooCommerce, Joomla, HubSpot CMS Hub, Webflow, Adobe Experience Manager, and…

    40k GitHub starsUsed in 1 repo~1.3k tokens
    Sales & SupportAuto-check passed
  • App Builder UI Scaffolder

    NeverSight/learn-skills.dev

    Generates React Spectrum UI code for Adobe Experience Cloud Shell apps and AEM UI Extensions from annotated patterns.

    216 GitHub starsUsed in 1 repo~2.2k tokens
    Frontend & DesignAuto-check passed
  • Authoring Analysis

    majiayu000/claude-skill-registry

    Analyze content sequences and determine authoring approach (default content vs blocks).

    666 GitHub starsUsed in 2 repos~3.1k tokens
    Auto-check passed
  • Block Inventory

    majiayu000/claude-skill-registry

    Survey available blocks from local AEM Edge Delivery Services project and Block Collection to understand the block palette available for authoring.

    666 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Identify Page Structure

    majiayu000/claude-skill-registry

    Identify section boundaries and content sequences within a scraped webpage for AEM Edge Delivery Services import.

    666 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

More from adobe/skills

All 105 skills in this repo
  • Scaffolds, implements, deploys and debugs Adobe Runtime actions in App Builder projects, with templates for webhooks, events, database CRUD, sequences and Asset Compute workers.

    195 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Launches Chrome with an unpacked extension over CDP, opens its sidepanel, popup or options page, and hands over to cdp-connect for clicks, typing and screenshots.

    195 GitHub stars~952 tokensUpdated today
    Auto-check passed
  • Extracts icons, metadata, text, forms, videos and social links from any web page with playwright-cli, with SVG icon classification and cleanup.

    195 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Page Langs

    adobe/skills

    Detect all languages used on a webpage — both declared (html@lang, hreflang alternate links, nested lang= attributes, meta content-language) and actually present in the body text (Google CLD3 via…

    195 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Page Prep

    adobe/skills

    Prepare any webpage for clean interaction by detecting and removing disruptive overlays (cookie banners, GDPR consent, modals, popups, newsletter signups, paywalls, login walls).

    195 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Page Reduce

    adobe/skills

    Reduce a webpage to a structural skeleton with semantic tokens.

    195 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about Workflow Model Design

What does Workflow Model Design do?

Design and create AEM Workflow models on AEM as a Cloud Service. Workflow Model Design is an agent skill from adobe/skills. Design and create AEM Workflow models on AEM as a Cloud Service.

When should I use Workflow Model Design?

Workflow Model Design fits situations like: creating workflow models via the Workflow Model Editor; content package XML; defining step types (PROCESS; DYNAMICPARTICIPANT.

How do I install Workflow Model Design in Claude Code?

Run `npx skills add adobe/skills --skill workflow-model-design -a claude-code`. Or copy the skill folder (plugins/aem/cloud-service/skills/aem-workflow/workflow-model-design in adobe/skills) into .claude/skills/workflow-model-design in your project. Claude Code loads it when a task matches its description.

How do I install Workflow Model Design in Codex?

Run `npx skills add adobe/skills --skill workflow-model-design -a codex`. Or copy the skill folder (plugins/aem/cloud-service/skills/aem-workflow/workflow-model-design in adobe/skills) into .agents/skills/workflow-model-design in your project. Codex loads it when a task matches its description.

Can I use Workflow Model Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add adobe/skills --skill workflow-model-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workflow-model-design, .gemini/skills/workflow-model-design, .github/skills/workflow-model-design and .opencode/skills/workflow-model-design in your project.

What does Workflow Model Design need to run?

Going by SKILL.md and its folder, Workflow Model Design needs the command-line tools its instructions call (mvn).

Does Workflow Model Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workflow Model Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workflow Model Design use?

Workflow Model Design is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workflow Model Design use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.6k tokens, read only when the agent opens those files.

What are the alternatives to Workflow Model Design?

Skills that share tags, products or a category with Workflow Model Design: Sanity Migration (sanity-io/agent-toolkit, 187 stars), Content Management Systems (github/awesome-copilot, 40k stars), App Builder UI Scaffolder (NeverSight/learn-skills.dev, 216 stars) and Authoring Analysis (majiayu000/claude-skill-registry, 666 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflow Model Design?

adobe (a GitHub organization) maintains it in adobe/skills, which has 195 GitHub stars. The repository holds 105 skills in this directory. The repository was last updated on October 6, 2026.

Source: adobe/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.