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.

Inside Claude Code:

/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 ships standalone.

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").

Guided setup (optional)

Prefer to be walked through it? Paste this into Claude Code and it handles install, verification, and a first run. Unlike some setup concierges, this one shows you every command before running it and never asks for store access up front:

Help me set up the awesome-ecom-skills plugin. Act as a guide: one step at a
time, short messages, and show me each command before you run it. Summarize
results in a line; show full output only if something fails.

Step 1 - Install two plugins: this skill pack, plus Shopify's official AI
toolkit (these skills pair with it for Admin API schema and validated
execution):
  claude plugin marketplace add kgelster/awesome-ecom-skills
  claude plugin install ecom@kgelster
  claude plugin marketplace add Shopify/Shopify-AI-Toolkit
  claude plugin install shopify-plugin@shopify-ai-toolkit

Step 2 - Verify: confirm both plugins appear in `claude plugin list` and that
the Shopify CLI responds to `shopify version`. Tell me exactly what is present
and what is missing; do not paper over a failed install.

Step 3 - Do NOT authenticate to my store yet. These skills auth per
engagement with the minimum scopes each SKILL.md declares, not one broad
grant at setup. Just ask me which store I will be working on and note the
domain.

Step 4 - Ask what I want to run first and offer these starting points:
  - Audit my catalog (shopify-catalog-audit: read-only, the natural first run)
  - Backfill missing SEO titles and descriptions (shopify-seo-metadata)
  - Backfill missing image alt text (shopify-alt-text)
  - Turn a Search Console 404 export into redirects (shopify-redirect-mapping)
When I pick one, load that skill and follow it exactly: preview count before
any mutation, minimum scopes, verify every write with an Admin API readback.
Never skip the preview.

Codex, Cursor, and friends (skills CLI)

The skills CLI installs straight from this repo into any agent that reads SKILL.md skills:

npx skills add https://github.com/kgelster/awesome-ecom-skills           # pick from all nine
npx skills add https://github.com/kgelster/awesome-ecom-skills --skill shopify-matrixify

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.

Every PR validates each SKILL.md against the Agent Skills spec via .github/scripts/validate_skills.py. Run the same check before you commit with git config core.hooksPath .githooks.

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.