Official agent skill

Customer Care

by anthropics in anthropics/commerce-agents

Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged…

OfficialApache-2.0Auto-check passed

Install Customer Care

skills CLI
$ npx skills add anthropics/commerce-agents --skill customer-care -a claude-code

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

GitHub CLI
$ gh skill install anthropics/commerce-agents customer-care --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/anthropics/commerce-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/shopping-agent/skills/customer-care .claude/skills/customer-care && 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
customer-care
GitHub stars
3.2k
Token cost
~828 tokens
SKILL.md length
498 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged…

  • SKILL.md covers Where each fact comes from, Status, Returns, refunds, and… and What this flow hands off
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Customer Care is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged, incomplete, or late, and questions about the store's terms or a membership. Not needed for finding, comparing, or choosing something new.

Its SKILL.md is about 830 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

  • “/customer-care”

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

Customer Care loads about 828 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 498 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~86
When it runs · the whole SKILL.md, loaded when a task matches
~828

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). 498 words, ~828 tokens.

Download SKILL.mdSave it as .claude/skills/customer-care/SKILL.md (or your agent's skills folder).
name
customer-care
description
Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged, incomplete, or late, and questions about the store's terms or a membership. Not needed for finding, comparing, or choosing something new.

Customer care

Below, "order" means whatever record this store keeps: an order, a booking, a line, or a ticket.

The customer has usually been waiting on something already. Tell them what the record shows, what the terms say, and what happens next, in that order and in few words.

Where each fact comes from

  • Dates, carriers, and tracking events come from a record fetched in this conversation: get_orders when the customer means their latest purchase, get_order_status when they name one. Until it is in hand, say only that you are looking it up.
  • Terms come from search_policies, quoted where the wording matters (the window, the condition, when a refund lands); policy text already in the conversation counts. When the terms do not address the question, say so.
  • Take today's date from the local time you were given. Do not ask for card numbers, passwords, or one-time codes, and do not repeat back any the customer pastes.

Status

  • Lead with the two facts they came for, the current state and the expected date, then one concrete next step. present_order_status shows the order; keep the text to what to do about it.
  • For a late order, give a plain acknowledgment, the revised expectation as the record shows it, and whichever option the retrieved terms provide for that state. Mention a credit or refund only when the terms name one; do not invent compensation or write an apology paragraph.
Show full SKILL.md (262 more words)Show less

Returns, refunds, and deliveries that went wrong

  • Work out eligibility from the record's status, its delivery date, and today's date, against the window the terms state; when the delivery date is an estimate, say the window is counted from an estimate. Report a passed window as passed; an exception is the store's decision, and present it as one.
  • Report a clause with a floor or a cap as written: a fee of "15% of the fare, minimum $25" comes to $25 on a $100 fare.
  • Put a multi-step procedure (return shipping, a damage report, a transfer) in present_guide and keep the text to the lines that apply to this customer.
  • For a damaged, incomplete, or missing delivery, acknowledge it in one sentence and give the route the terms lay out (the deadline, whether a photo is wanted, replacement or refund), using what the customer has already told you.

What this flow hands off

  • This flow reads. Cancelling, rebooking, changing an address or a line, refunds, and anything else that alters the record or moves money happens in the app's support flow: describe it as the next step and make clear it has not happened here.
  • Fetch the record before handing off all the same; whether the step is possible depends on its state, and the caveat comes from the retrieved terms.
  • With an upset customer, drop to short factual sentences on the situation and the next step.
  • When one message carries a problem and a shopping request, settle the problem first, then take up the request in full in the same turn.

© 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 shopping-agent/skills/customer-care of anthropics/commerce-agents.

Open the folder on GitHubat commit fd4d592

Compare with similar skills

Customer Care 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.

Customer Care compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Customer Care this skillanthropics/commerce-agents3.2k—~828Automated safety check: PassApache-2.0
Etsy Custom Ordersnexscope-ai/eCommerce-Skills1.1k—~431Automated safety check: PassMIT
Customizeanthropics/claude-for-legal9.6k4 repos~1.2kAutomated safety check: PassApache-2.0
Customizeanthropics/claude-for-legal9.6k3 repos~1.2kAutomated safety check: PassApache-2.0
Customizeanthropics/claude-for-legal9.6k3 repos~1.2kAutomated safety check: PassApache-2.0
Customizeanthropics/claude-for-legal9.6k3 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Etsy Custom Orders

    nexscope-ai/eCommerce-Skills

    Custom order management — communication templates, pricing, delivery timelines, return policies

    1.1k GitHub stars~431 tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your IP practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 4 repos~1.2k tokens
    Legal & ComplianceAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your corporate practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 3 repos~1.2k tokens
    Legal & ComplianceAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your litigation practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 3 repos~1.2k tokens
    Legal & ComplianceAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your privacy practice profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 3 repos~1.1k tokens
    Legal & ComplianceAuto-check passed
  • Customize

    anthropics/claude-for-legal

    Official

    Guided customization of your legal clinic profile — change one thing without re-running the whole cold-start interview.

    9.6k GitHub starsUsed in 3 repos~1.2k tokens
    Auto-check passed

More from anthropics/commerce-agents

All 16 skills in this repo
  • Commerce Evals

    anthropics/commerce-agents

    Official

    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.

    3.2k GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed
  • Catalog Listings

    anthropics/commerce-agents

    Official

    Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator…

    3.2k GitHub stars~1k tokensUpdated 8 days ago
    Auto-check passed
  • Commerce Architecture

    anthropics/commerce-agents

    Official

    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.

    3.2k GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed
  • Commerce Merchant Operations

    anthropics/commerce-agents

    Official

    The reference merchant agent, covering its flows, staged changes and host approval, metrics grounding, the analysis delegate, store memory, components, and marketplace rules.

    3.2k GitHub stars~2.1k tokensUpdated 8 days ago
    Auto-check passed
  • Commerce Prompt Caching

    anthropics/commerce-agents

    Official

    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…

    3.2k GitHub stars~2k tokensUpdated 8 days ago
    Auto-check passed
  • Commerce Trust Safety

    anthropics/commerce-agents

    Official

    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.

    3.2k GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed

Questions about Customer Care

What does Customer Care do?

Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged…. Customer Care is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. Help after a purchase or booking, covering the status of an order or delivery whether or not the customer names it, returns, refunds, exchanges, and cancellations, an item that arrived damaged, incomplete, or late, and questions about the store's terms or a membership.

How do I install Customer Care in Claude Code?

Run `npx skills add anthropics/commerce-agents --skill customer-care -a claude-code`. Or copy the skill folder (shopping-agent/skills/customer-care in anthropics/commerce-agents) into .claude/skills/customer-care in your project. Claude Code loads it when a task matches its description.

How do I install Customer Care in Codex?

Run `npx skills add anthropics/commerce-agents --skill customer-care -a codex`. Or copy the skill folder (shopping-agent/skills/customer-care in anthropics/commerce-agents) into .agents/skills/customer-care in your project. Codex loads it when a task matches its description.

Can I use Customer Care 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 customer-care -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/customer-care, .gemini/skills/customer-care, .github/skills/customer-care and .opencode/skills/customer-care in your project.

What does Customer Care need to run?

SKILL.md names no scripts, command-line tools or credentials: Customer Care is instructions for the agent only.

Does Customer Care 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 Customer Care 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 Customer Care use?

Customer Care 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 Customer Care use?

About 828 tokens (SKILL.md is roughly 3.3k 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 Customer Care?

Skills that share tags, products or a category with Customer Care: Etsy Custom Orders (nexscope-ai/eCommerce-Skills, 1.1k stars), Customize (anthropics/claude-for-legal, 9.6k stars), Customize (anthropics/claude-for-legal, 9.6k stars) and Customize (anthropics/claude-for-legal, 9.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Customer Care?

anthropics (a GitHub organization, an official publisher) maintains it in anthropics/commerce-agents, which has 3,198 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.