Scaffold an Anthropic commerce agent on commercetools

Labs
This is a commercetools Labs 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

This is a Labs Skill. It is part of the commercetools Labs plugin, which is experimental, unsupported, and subject to change. The Labs plugin requires the commercetools plugin, which supplies the commercetools Knowledge MCP and the Skill environment that Labs builds on.
Install the plugins

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), which the Labs plugin requires:

    /plugin install commercetools@commercetools

  3. Install the commercetools Labs plugin:

    /plugin install commercetools-labs@commercetools
Reload plugins

If you've updated the plugins or installed them 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, install the commercetools plugin and the commercetools-labs plugin.

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.