Scaffold an Anthropic commerce agent on commercetools

experimental
This is a commercetools Agent Skill. The Skill source is available on GitHub. You can explore our full Skills catalogue here.

Description

Entrypoint for scaffolding a shopping or merchant agent on the anthropics/commerce-agents packages, backed by commercetools. Clones the commercetools/commercetools-anthropic-agents reference implementation and interviews the user before generating code. Use when the user wants to build an agent (shopping, merchant, or both) backed by commercetools, and no project scaffold exists yet.

Installation

Recommended: install the full commercetools plugin. It includes this Skill, every other commercetools Skill, our pre-tuned Subagents, and the commercetools Knowledge MCP — which gives AI live access to the commercetools docs, GraphQL/OpenAPI schemas, and query validation. You only install once; every Skill on this site becomes available in every session.
Install the plugin

In any Claude Code session, run the following commands one at a time:

  1. Add the commercetools AI marketplace:

    /plugin marketplace add commercetools/commercetools-ai-plugins

  2. Install the commercetools AI plugin (Skills + Subagents + MCP):

    /plugin install commercetools@commercetools
Reload plugins

If you've updated the plugin or installed it in another window and need the current session to pick up the latest version:

/reload-plugins
Claude Desktop
Customize -> Personal plugins -> Create plugin -> Add marketplace -> Add commercetools/commercetools-ai-plugins. Then, click on the plugin and click Install.

Instructions Included

SKILL.md

Scaffold an Anthropic commerce agent on commercetools

This skill is the starting point for building a shopping agent, a merchant agent, or both, on the anthropics/commerce-agents packages with a commercetools backend. It does not contain the scaffolding logic itself — that logic, and the reference implementation it is built from, live in a separate repo: commercetools/commercetools-anthropic-agents.
That repo already did this integration once against a live commercetools project. Its ct_common/ is reusable commercetools infrastructure (auth, GraphQL/REST transport, price and id mapping, caching, error handling), its CLAUDE.md is the decision record for every non-obvious choice made along the way, and its scaffold-commercetools-agent command is the actual interview-and-generate flow this skill hands off to.

Steps

  1. If a local checkout of commercetools/commercetools-anthropic-agents does not already exist, clone it:
    git clone https://github.com/commercetools/commercetools-anthropic-agents
  2. Change into the clone and run its scaffold-commercetools-agent command. That repo registers its own plugin (commercetools-commerce-agent, via its .claude-plugin/marketplace.json) — if it is installed as a plugin, run /scaffold-commercetools-agent directly. Otherwise, read the command body straight from plugins/commercetools-commerce-agent/commands/scaffold-commercetools-agent.md and follow it. Pass along whatever the user has already told you about the agent being built — role (shopping, merchant, or both), and the commercetools project key if known.

  3. Follow that command's interview, plan-back, and scaffold steps as written. Do not duplicate, summarize, or reimplement its logic here — this skill only exists to get the user from "I want an agent backed by commercetools" to that repo, with the right context in hand.