Aria Roles
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Use valid ARIA role values.
How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields.
OfficialApache-2.0Auto-check passed
Install Commerce Architecture
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install anthropics/commerce-agents commerce-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .claude/skills/commerce-architecture && rm -rf skills-srcUse ~/.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/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .claude/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install anthropics/commerce-agents commerce-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .agents/skills/commerce-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .agents/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install anthropics/commerce-agents commerce-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .cursor/skills/commerce-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .cursor/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/anthropics/commerce-agents.git --path plugins/commerce-builder/skills/commerce-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install anthropics/commerce-agents commerce-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .gemini/skills/commerce-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .gemini/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install anthropics/commerce-agents commerce-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .github/skills/commerce-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .github/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add anthropics/commerce-agents --skill commerce-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install anthropics/commerce-agents commerce-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/anthropics/commerce-agents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/commerce-builder/skills/commerce-architecture .opencode/skills/commerce-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "commerce-architecture" agent skill from https://github.com/anthropics/commerce-agents/tree/main/plugins/commerce-builder/skills/commerce-architecture into .opencode/skills/commerce-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "commerce-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
commerce-architecture- GitHub stars
- 3.2k
- Token cost
- ~1.7k tokens
- SKILL.md length
- 802 words
- Files
- 1
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields.
- SKILL.md covers One loop, Where a rule lives, Skills and The backend interface, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Commerce Architecture is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields. Load when designing or reviewing the structure of a shopping or merchant agent.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Reference blueprint for building shopping and merchant agents with Claude. Examples in retail, commerce, telecom, and entertainment included. The licence is Apache-2.0.
Example prompts
- “/commerce-architecture”
What it can do on your machine
Read from SKILL.md and the folder at commit fd4d592. 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
No scripts in the folder and no shell commands in SKILL.md.
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
Commerce Architecture loads about 1.7k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 802 words of instructions outside code blocks.
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 anthropics/commerce-agents at commit fd4d592, republished under its Apache-2.0 licence (© anthropics). 802 words, ~1,658 tokens.
Download SKILL.mdSave it as
.claude/skills/commerce-architecture/SKILL.md (or your agent's skills folder).- name
- commerce-architecture
- description
- How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields. Load when designing or reviewing the structure of a shopping or merchant agent.
Commerce agent architecture
Paths are in the reference repo: commerce_common/ is commerce-common/commerce_common/, shopping_agent/ is
shopping-agent/core/shopping_agent/, merchant_agent/ is merchant-agent/core/merchant_agent/, and the runtimes are
shopping-agent/runtime-messages-api/shopping_agent_runtime/ and merchant-agent/runtime-messages-api/merchant_agent_runtime/.
One loop
- One model owns the conversation. A turn is
ShoppingAgent.stream_turnorMerchantAgent.stream_turn(each runtime'sorchestrator.py): the model reads the cached prompt, calls tools (one round's calls run concurrently), and ends with text plus presentation calls. There is no router, classifier, or hand-off. - Every call on every path runs through the role executor (
ShoppingToolExecutorinshopping_agent/executor.py,MerchantToolExecutorinmerchant_agent/executor.py) overBaseToolExecutorincommerce_common/execution.py. The Messages API runtime, the Agent SDK toolset, and the MCP server call the sameexecute, which never raises; aftermax_tool_iterationsrounds (commerce_common/config.py) the runtime forces a round without tools.
Where a rule lives
| A rule that applies | Lives in | Reference |
|---|---|---|
| While one call's arguments are being filled in | That tool's description | build_tools in each role's tools/registry.py |
| On most turns: cart and checkout, the staged-write contract, presentation grammar, tool order, trust rules | The static prompt | build_static_system in each role's prompt.py |
| On the minority of requests that need a multi-step procedure | A skill, loaded on demand | shopping-agent/skills/, merchant-agent/skills/ |
A rule the core journey needs on most conversations moves a layer down. This table is the one statement of the layering.
Skills
- A skill is a directory holding
SKILL.md: frontmatternameanddescription, then the body (parse_skill_mdincommerce_common/skills.py). The description names the request class; it carries no sample utterances. - The static prompt carries the index alone (
SkillRegistry.index_block, sorted by name) andload_skillreturns one body (_load_skillincommerce_common/execution.py). On the Agent SDK,ensure_project_skillslinks the same directories into.claude/skills/andSKILL_TOOL_ADAPTERpoints the model at the SDK'sSkilltool (commerce_common/agent_sdk.py); the hosted manifests list the directories underskills[]inagent.yaml.
The backend interface
A deployment implements one abstract class per role; nothing else reaches its systems.
StorefrontBackend(shopping_agent/backend.py): 11 abstract methods, catalog (2), cart (4), preferences (1), orders (2), policies (1), fulfillment (1);get_account_context,get_disclosure, andcheckout_handoffhave defaults. No method places an order or moves money;checkout_handoffnames where payment happens (a hosted checkout URL, or one per seller) and the host renders it.MerchantBackend(merchant_agent/backend.py): 16 abstract methods, reads (8: performance 3, catalog 2, inventory and order health 2, pricing 1) and the change lifecycle (8: fivestage_*,get_pending_changes,apply_change,discard_change);execute_analysis_query,get_analysis_schema,get_merchant_contexthave defaults.- A product or listing sold by size, color, or tier is a family record carrying
options, its variants each a record withoption_valuesandvariant_of; the cart and price or restock writes take a variant's id and the gates hold a family's.docs/backends.mdhas the mapping from common catalog models and what to return for a figure the platform cannot supply. - Eligibility, pricing, inventory, and quantity rules are enforced in the backend; the gates check provenance and caps (commerce-trust-safety). Everything a backend returns is fenced before the model reads it.
- A system that is not wired yet is a method that fails (merchant methods raise
ChangeNotApplicablefrommerchant_agent/changes.py); the tool stays registered, so prompt bytes do not change. A system the business does not have at all is absent: anenable_*switch on the role's config turned off, which removes its tools (absent_tools()), prompt lines, and grounding rule on all three paths, and the executor refuses those names; the skills that need it are parked underskills/_staged/, and the bytes are then fixed for that deployment.NotOffered(shopping_agent/backend.py) is the narrower signal: one item or seller the store does not serve while the system itself is on. executor_class=onShoppingAgent/MerchantAgent, the SDK toolsets, and the MCP servers'build_servertakes a subclass of the role's executor for a deployment's owndomain_errormapping or result wording.
Show full SKILL.md (192 more words)Show less
Delegates
A second model call takes one shape: a DelegateExtension (commerce_common/delegation.py). It receives a brief
and the handles in DelegationContext, never the conversation or the executor; it returns one result validated
against result_model; it cannot write, present, or call a delegate; _run_delegate in commerce_common/execution.py
caps its calls per turn at max_delegate_calls_per_turn. MerchantAgent takes extra_delegates, and its
built-in instance is run_analysis (commerce-merchant-operations). ShoppingAgent registers none.
Model fields
model runs the turn loop and memory_model the post-turn extraction (BaseAgentConfig in commerce_common/config.py);
analysis_model runs the delegate, and None means model (MerchantAgentConfig in merchant_agent/config.py). The
SDK runtimes copy config.model into the options; the manifests set model:. Choose the values with your own evals.
Do not
- Vary
tools[]or the static prompt by request (commerce-prompt-caching). - Put a most-turns rule in a skill, or a one-tool rule in the prompt.
- Enforce a cap or a permission in prompt text alone; it belongs in the executor or the backend.
- Let the model author a price, a figure, or a term; components are joined from server records (commerce-ui-tools).
- Add a domain tool to a core package; a vertical adds UI through
PresentationExtensionand keeps the rest in its own code.
© anthropics, 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
Just SKILL.md in plugins/commerce-builder/skills/commerce-architecture of anthropics/commerce-agents.
Open the folder on GitHubat commit fd4d592
Compare with similar skills
Commerce Architecture 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Commerce Architecture this skillanthropics/commerce-agents | 3.2k | — | ~1.7k | Automated safety check: Pass | Apache-2.0 | |
| Aria Rolesthedaviddias/Front-End-Checklist | 74k | — | ~515 | Automated safety check: Pass | MIT | |
| Azure Role Selectorgithub/awesome-copilot | 40k | 2 repos | ~246 | Automated safety check: Pass | MIT | |
| Aria Deprecated Rolethedaviddias/Front-End-Checklist | 74k | — | ~441 | Automated safety check: Pass | MIT | |
| Fp Either Refsickn33/agentic-awesome-skills | 47k | 2 repos | ~655 | Automated safety check: Pass | MIT | |
| OMP Sub-Agent Role Presetsagentscope-ai/QwenPaw | 36k | — | ~1.1k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Azure Role Selector
github/awesome-copilot
When user is asking for guidance for which role to assign to an identity given desired permissions, this agent helps them understand the role that will meet the requirements with least privilege…
Aria Deprecated Role
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Avoid using deprecated ARIA roles.
Fp Either Ref
sickn33/agentic-awesome-skills
Quick reference for Either type. An agent skill from sickn33/agentic-awesome-skills.
OMP Sub-Agent Role Presets
agentscope-ai/QwenPaw
Gives the allowed_tools and skills preset for each OMP sub-agent role, to apply when calling spawn_subagent.
Building Role Mining For Rbac Optimization
mukul975/Anthropic-Cybersecurity-Skills
Apply bottom-up and top-down role mining techniques, including clustering algorithms and formal concept analysis, to discover optimal RBAC roles from existing user-permission assignments…
More from anthropics/commerce-agents
All 16 skills in this repo- Official
Commerce Evals
anthropics/commerce-agents
Authoring and running behavioral evals for a shopping or merchant agent, covering the case shape, authoring rules, code graders and judges, the run pattern, and poisoned fixtures.
- Official
Catalog Listings
anthropics/commerce-agents
Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator…
- Official
Commerce Merchant Operations
anthropics/commerce-agents
The reference merchant agent, covering its flows, staged changes and host approval, metrics grounding, the analysis delegate, store memory, components, and marketplace rules.
- Official
Commerce Prompt Caching
anthropics/commerce-agents
The reference agents' cache-stable request assembly, covering the static system and per-request context split, the fixed tool list, the rolling conversation breakpoint, which config fields are…
- Official
Commerce Trust Safety
anthropics/commerce-agents
The rules the reference agents enforce in code for third-party content, writes, grounding, identity, and memory, each with its module, plus two adversarial-eval rules.
- Official
Commerce UI Tools
anthropics/commerce-agents
The reference presentation-tool contract, covering server-side enrichment, suggestion chips, the event stream, progressive rendering, both roles' built-in components, and adding a vertical component.
Questions about Commerce Architecture
What does Commerce Architecture do?
How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields. Commerce Architecture is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. How the reference commerce agents of either role are structured, covering the loop, where each rule lives, skills, the backend interface, delegates, and model fields.
How do I install Commerce Architecture in Claude Code?
Run `npx skills add anthropics/commerce-agents --skill commerce-architecture -a claude-code`. Or copy the skill folder (plugins/commerce-builder/skills/commerce-architecture in anthropics/commerce-agents) into .claude/skills/commerce-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Commerce Architecture in Codex?
Run `npx skills add anthropics/commerce-agents --skill commerce-architecture -a codex`. Or copy the skill folder (plugins/commerce-builder/skills/commerce-architecture in anthropics/commerce-agents) into .agents/skills/commerce-architecture in your project. Codex loads it when a task matches its description.
Can I use Commerce Architecture 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 anthropics/commerce-agents --skill commerce-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/commerce-architecture, .gemini/skills/commerce-architecture, .github/skills/commerce-architecture and .opencode/skills/commerce-architecture in your project.
What does Commerce Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Commerce Architecture is instructions for the agent only.
Does Commerce Architecture 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 Commerce Architecture 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 Commerce Architecture use?
Commerce Architecture is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Commerce Architecture use?
About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Commerce Architecture?
Skills that share tags, products or a category with Commerce Architecture: Aria Roles (thedaviddias/Front-End-Checklist, 74k stars), Azure Role Selector (github/awesome-copilot, 40k stars), Aria Deprecated Role (thedaviddias/Front-End-Checklist, 74k stars) and Fp Either Ref (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Commerce Architecture?
anthropics (a GitHub organization, an official publisher) maintains it in anthropics/commerce-agents, which has 3,193 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 2, 2026.
Source: anthropics/commerce-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.