awesome-ecom-skills

Shopify's plugin gives your agent the API. This gives it the playbook.

Shopify's official AI toolkit gives your agent the Admin API: schema, mutations, reference. It can't give judgment: which category ID not to guess, why a blank Matrixify cell silently deletes a metafield, how to backfill SEO metadata without clobbering a human's copy. These Agent Skills are that judgment: model-readable playbooks your agent loads on demand and runs against a live store, each distilled from real agency work with the numbers left in.

Built for Shopify merchants and the agencies who run their catalogs: taxonomy, SEO metadata, structured data, alt text, redirects, and bulk data at catalog scale. Not an app-dev or theme-dev kit, and no synthetic benchmark stat to sell you: just the operating knowledge that keeps an agent from quietly wrecking a live store.

/plugin marketplace add kgelster/awesome-ecom-skills
/plugin install ecom@kgelster

The catalog cleanup suite

The core of the repo: six skills for getting a messy catalog into shape, from finding the problems to fixing the data. They cross-reference each other: audit finds, the rest fix.

Also included

⚠️ Read before you install

These skills direct an agent to mutate a live Shopify store: archive products, delete metafields, rewrite descriptions, create redirects. That is exactly as powerful as it sounds.

• Review the skills before installing. They're plain Markdown; read what they'll do. Nothing here phones home or auto-runs (they're reference guides), but you're handing an agent a playbook for your storefront's data.
• The recipes are preview-first and safe-mode by doctrine. Every mutation is preceded by a read-only count query, safe mode fills missing / MERGEs / hides before it overwrites / REPLACEs / deletes, and every write is verified via an Admin API readback. But doctrine is not a seatbelt: you own the store and the risk. Run the preview, check the number, take a Matrixify backup export before a large write.
• Never paste tokens into files. If you use the Shopify CLI or the official AI toolkit, auth is interactive and there's no token to store. If you script against the Admin API directly, the token lives in an environment variable, never on disk.

Install

Claude Code (plugin, recommended)

/plugin marketplace add kgelster/awesome-ecom-skills
/plugin install ecom@kgelster

Installs all nine skills as the ecom plugin; run /reload-plugins (or restart) to load them. They activate automatically when your prompt matches (e.g. "my Matrixify import wiped a bunch of metafields", "backfill alt text on my product photos", "map the old URLs after my replatform").

Manual copy (any Agent-Skills harness)

git clone https://github.com/kgelster/awesome-ecom-skills
cp -r awesome-ecom-skills/skills/* ~/.claude/skills/

Each skill directory is self-contained; copy just the ones you want.

Other harnesses

Every SKILL.md is harness-neutral Markdown with standard Agent-Skills frontmatter (spec). Drop the skills/* directories wherever your agent framework discovers skills, or point it at this repo.

What's inside a skill

skills/shopify-<area>/
  SKILL.md            # the playbook (frontmatter + body, ~100-200 lines)
  references/*.md     # heavy detail: query recipes, prompts, gotchas, loaded on demand

There is no scripts/ directory anywhere. This collection ships recipes, not programs: the GraphQL and curl blocks are copy-and-adapt starting points your agent runs against the current schema and discards. That keeps the skills honest across Shopify's quarterly API changes instead of shipping a binary that silently rots. Skills are original prose: the operational lessons agency work teaches, not a copy of shopify.dev. The official docs remain canonical for the API itself.

Contributing

Have a hard-won Shopify lesson? Copy template/SKILL.md and follow its authoring notes: original prose (no docs paste), read secrets from the environment, preview-before-mutate and safe-mode defaults, and show the reader how to verify the change via the Admin API. PRs welcome.

Versions tested

Distilled against Shopify Admin API 2025-07 in July 2026. Shopify deprecates API versions on a rolling quarterly schedule and Google changes rich-result eligibility often, so verify version-specific claims against shopify.dev and each skill's Provenance and maintenance section before trusting them. When in doubt, the Admin API readback is the source of truth, not the storefront (it's CDN-cached).

License

MIT. See LICENSE.

Not affiliated with Shopify. "Shopify" and "Matrixify" are used descriptively; this is an independent, community-built collection. Client work referenced in these skills is anonymized.