Official agent skill

Catalog Listings

by anthropics in 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…

OfficialApache-2.0Auto-check passed

Install Catalog Listings

skills CLI
$ npx skills add anthropics/commerce-agents --skill catalog-listings -a claude-code

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

GitHub CLI
$ gh skill install anthropics/commerce-agents catalog-listings --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/merchant-agent/skills/catalog-listings .claude/skills/catalog-listings && 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
catalog-listings
GitHub stars
3.2k
Token cost
~1k tokens
SKILL.md length
625 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • SKILL.md covers Where each fact comes from, The copy you propose, Audits and categorization and Bulk fixes, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Catalog Listings is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator supplies, and content-quality audits and bulk fixes across many listings. Not needed for questions about how a listing is performing.

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

  • “/catalog-listings”

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

Catalog Listings loads about 1k tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 625 words of instructions outside code blocks.

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

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). 625 words, ~1,018 tokens.

Download SKILL.mdSave it as .claude/skills/catalog-listings/SKILL.md (or your agent's skills folder).
name
catalog-listings
description
Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator supplies, and content-quality audits and bulk fixes across many listings. Not needed for questions about how a listing is performing.

Catalog and listings

Below, "listing" means whatever this operation sells: a product, a room type, a plan or device, or an event tier.

Read the record, write the weak or missing content out in full, and stage it; the live listing changes only after the operator approves.

Where each fact comes from

  • Fetch the record with get_listing before proposing an edit. A search_listings row carries the summary fields; the attributes, description, and review snippets an edit rests on are in the record.
  • Write in the brand voice and naming conventions saved in memory, without asking the operator to restate them.
  • Take an attribute value from the record or from what the operator said in this conversation. A value that is merely likely for the type, or consistent with the attributes beside it, is a fabrication: leave the field blank or ask, one line per open field, and propose the rest of the fix without waiting.
  • Review snippets are evidence about the item; a line of review praise stays a review line and does not become a claim in the description.
  • Treat a spec sheet or note the operator pastes as source material for the edit they asked for: put its facts into the listing in the operator's voice, and list the fields it does not cover as open questions in the same reply.

The copy you propose

  • Propose the finished title or description, approvable unchanged: what the item is, who it is for, and what the record shows is notable. Make a strong claim only where an attribute backs it ("sleeps six" from the record) and leave out a superlative with nothing behind it.
  • Fill a missing attribute from a value that is already elsewhere in the record; a description that mentions a balcony supplies the balcony attribute.
  • Search-friendliness is which record facts the title carries: bring forward the words a buyer would type (occupancy, allowance, section, material, size) and drop filler that carries none of them.
  • Write an image callout as a description of the shot to add and what it should show; do not write the listing as though the photo exists.
Show full SKILL.md (271 more words)Show less

Audits and categorization

  • Start an audit from search_listings with an empty query and the quality filter, then get_listing on the candidates. Measure the same four things on every listing: missing attributes, descriptions too thin to search on, a category the record contradicts, and no image where the type usually has one.
  • Rank findings by impact, so a busy listing with missing attributes comes before a quiet one with a clumsy title. Attach a fix to each finding and group the findings by kind of fix, so the operator approves a pattern ("add the occupancy attribute on these nine") instead of working through complaints one at a time.
  • Stage a categorization fix as a listing update like any other, this turn: the destination is a category a catalog read this conversation returned, or else the name the request implies, written into the note as the assumption; the preview shows the category before and after, and is where the operator corrects the name.

Bulk fixes

  • Show the pattern on one or two listings first and stage the rest after the operator confirms it.
  • Stage in batches within the per-change item cap and say how many batches there are. Price and stock values belong to the pricing and inventory flows; a protected field such as a compliance note or a tax category is one the guardrail will hold back.
  • A bulk change contains the edits the operator asked for; offer anything you notice on the way through as a separate proposal.

Stage and preview

  • Stage each edit with stage_listing_update; the preview carries the diff, and the staging note says why the change is right.

© 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 merchant-agent/skills/catalog-listings of anthropics/commerce-agents.

Open the folder on GitHubat commit fd4d592

Compare with similar skills

Catalog Listings 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.

Catalog Listings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Catalog Listings this skillanthropics/commerce-agents3.2k—~1kAutomated safety check: PassApache-2.0
Duplicate Descriptionthedaviddias/Front-End-Checklist74k—~695Automated safety check: PassMIT
Improve Oaselastic/kibana21k—~4.8kAutomated safety check: PassCustom licence
Music Listruvnet/ruflo74k—~332Automated safety check: PassMIT
Meta Descriptionthedaviddias/Front-End-Checklist74k—~513Automated safety check: PassMIT
Meta Titlethedaviddias/Front-End-Checklist74k—~494Automated safety check: PassMIT

Similar skills

  • Duplicate Description

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's meta tag uniqueness, generating page-specific meta descriptions, or reviewing CMS templates that inject the same description globally.

    74k GitHub stars~695 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Improve Oas

    elastic/kibana

    Official

    Add or improve OpenAPI descriptions, examples, and code samples for a Kibana API area.

    21k GitHub stars~4.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • Music List

    ruvnet/ruflo

    List the account's saved music productions with metadata and audiourl

    74k GitHub stars~332 tokensUpdated yesterday
    Auto-check passed
  • Meta Description

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing page metadata or generating descriptions for new pages.

    74k GitHub stars~513 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Meta Title

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing page metadata or generating SEO-optimized titles.

    74k GitHub stars~494 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Audio Descriptions

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing rendered HTML, interactive components, or design-system patterns related to Provide audio descriptions for video.

    74k GitHub stars~549 tokensUpdated 4 days ago
    Frontend & DesignAuto-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 9 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 9 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 9 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 9 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 9 days ago
    Auto-check passed
  • Commerce UI Tools

    anthropics/commerce-agents

    Official

    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.

    3.2k GitHub stars~1.7k tokensUpdated 9 days ago
    Auto-check passed

Questions about Catalog Listings

What does Catalog Listings do?

Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator…. Catalog Listings is an agent skill from anthropics/commerce-agents, published by the product's own GitHub organization. Creating and improving listing content, covering titles, descriptions, attribute completeness, categorization fixes, image callouts written as text, edits written from material the operator supplies, and content-quality audits and bulk fixes across many listings.

How do I install Catalog Listings in Claude Code?

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

How do I install Catalog Listings in Codex?

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

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

What does Catalog Listings need to run?

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

Does Catalog Listings 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 Catalog Listings 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 Catalog Listings use?

Catalog Listings 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 Catalog Listings use?

About 1k tokens (SKILL.md is roughly 4.1k 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 Catalog Listings?

Skills that share tags, products or a category with Catalog Listings: Duplicate Description (thedaviddias/Front-End-Checklist, 74k stars), Improve Oas (elastic/kibana, 21k stars), Music List (ruvnet/ruflo, 74k stars) and Meta Description (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Catalog Listings?

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.