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
- If a local checkout of
commercetools/commercetools-anthropic-agentsdoes not already exist, clone it:
git clone https://github.com/commercetools/commercetools-anthropic-agents
-
Change into the clone and run its
scaffold-commercetools-agentcommand. 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-agentdirectly. Otherwise, read the command body straight fromplugins/commercetools-commerce-agent/commands/scaffold-commercetools-agent.mdand 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. -
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.