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.

🔎 shopify-catalog-audit _{Find the problems. A cheap deterministic index plus hypothesis-driven triage over a catalog too big to read whole: missing photos, thin descriptions, pricing anomalies.}	🗂️ shopify-category-taxonomy _{Assign the Standard Product Taxonomy category, then fill its category metafields. Verify IDs against the source (never guess), mint the reserved-namespace value metaobjects.}	🧹 shopify-catalog-cleanup _{Fix the debris the audit finds: bulk-archive dead products, delete the orphaned metafields behind ghost review stars, strip double-bold HTML artifacts from descriptions.}
🏷️ shopify-seo-metadata _{Safe-mode backfill of missing SEO titles and descriptions across products, collections, pages, and blog posts. Fill missing only, preview-first, verify via the API.}	🖼️ shopify-alt-text _{Backfill image alt text across product media and the Files library (two different mutations). Describe the image, not the sales pitch; fill missing only.}	📦 shopify-matrixify _{The bulk-data workhorse. Backup-export-first doctrine, MERGE vs REPLACE, the blank-cell-deletes-a-metafield trap, and programmatic CSV generation rules.}

Also included

↪️ shopify-redirect-mapping _{Turn a Search Console 404 export into live 301s after a migration. Recall-first matching, per-type thresholds, never silently fall back to the homepage.}	📐 shopify-json-ld _{Supplemental-only structured data: never duplicate the theme's Product schema, ship JSON-LD from a metafield + Liquid snippet, hallucination-guarded generation.}	🎯 ecom-landing-pages _{Landing-page ideation and build blueprint: an 8-archetype angle taxonomy keyed to traffic source, 4-axis prioritization, and a 10-section page anatomy.}
➕ contribute _{Got a hard-won Shopify lesson? Copy the template and open a PR. Original prose, env-var secrets, preview-before-mutate, verify against ground truth.}

⚠️ 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.