Ira Bodnar··Updated ·13 min read

Claude Skills for Shopify: 10 SKILL.md Files and Prompts

Quick answer: Save each recurring store task as a Claude skill that names the Admin API objects to read and what to hand back. Ryze AI is the best Claude connector for running these skills on live Shopify content and orders, with one caveat: the default store connection has no theme file edits and orders stop at 60 days.

Below: 10 SKILL.md files, the Shopify objects each one reads or edits, install steps and the live-data setup.

Ryze AI · Paid Ads

Shopify skills on live store data

  • 7-day free trial, $89 a month flat

Used by 2,000+ marketers

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

The 10 Claude skills for Shopify at a glance

Skills 01 to 06 only read. Skills 07 to 10 change the store, so each one stops for your go-ahead first.

  1. 01Product SEO auditMissing or weak SEO titles and descriptions

    Main Shopify fields: seo, handle, status

    Ryze AI tools: shopify__read

  2. 02Collection SEO auditCollections with empty SEO fields

    Main Shopify fields: seo, handle, descriptionHtml

    Ryze AI tools: shopify__read

  3. 03Catalog hygieneDrafts, archived items, missing types

    Main Shopify fields: status, productType, vendor, tags

    Ryze AI tools: shopify__read

  4. 0460-day order recapOrders and top products in the last 60 days

    Main Shopify fields: createdAt, currentTotalPriceSet, lineItems

    Ryze AI tools: shopify__read

  5. 05Blog article checkOutdated claims inside articles

    Main Shopify fields: blogs, articles, body

    Ryze AI tools: shopify__read, shopify__search_content

  6. 06Page checkStale text on shipping, returns and about pages

    Main Shopify fields: pages, body

    Ryze AI tools: shopify__read, shopify__search_content

  7. 07SEO field rewriteNew SEO titles and descriptions for products

    Main Shopify fields: productUpdate, seo

    Ryze AI tools: shopify__read, shopify__write

  8. 08Find and replaceFix one phrase across descriptions or pages

    Main Shopify fields: descriptionHtml, body

    Ryze AI tools: shopify__search_content, shopify__edit_content

  9. 09Collection SEO rewriteSEO fields for collections

    Main Shopify fields: collectionUpdate, seo

    Ryze AI tools: shopify__read, shopify__write

  10. 10Cleanup candidatesDelete named draft or archived products

    Main Shopify fields: productDelete, status

    Ryze AI tools: shopify__read, shopify__delete

The tool names come from the Ryze AI connector's Shopify tool list. Each skill names Admin API objects and fields from Shopify's documentation, and Claude writes the GraphQL itself.

What are Claude skills for Shopify?

A Claude skill for Shopify is a saved SKILL.md file that tells Claude which store objects to look at, what to check and how to hand the result back. Per Anthropic's Agent Skills docs, the file starts with a name and a description, and Claude loads the rest only when a request matches the description.

The name takes up to 64 lowercase letters, numbers and hyphens and cannot contain the words claude or anthropic, so every skill here starts with shopify. The description, up to 1,024 characters, says what the skill does and when to use it.

  1. What it is

    One-off prompt
    A question in chat
    Skill
    A saved file with a fixed check and output
    Store connection
    Tools Claude calls to reach the store
  2. Setup

    One-off prompt
    None
    Skill
    Save once per Claude app
    Store connection
    Connect the store and add the connector
  3. Same steps each run

    One-off prompt
    No
    Skill
    Yes
    Store connection
    Depends on the prompt or skill

A skill describes the work; it does not hold store access. Without a connection, attach a product export with matching columns. Shopify also publishes its own AI toolkit with agent skills and a Dev MCP server for developers. It feeds coding agents Shopify docs and API schemas and does not connect to a store, so it covers a different job from the skills below.

How to install the skills in Claude Code and claude.ai

Claude Code

Save each block as ~/.claude/skills/<skill-name>/SKILL.md for yourself, or .claude/skills/<skill-name>/SKILL.md in a project. Claude picks a skill when your request matches it, or you type its name after a slash, such as /shopify-product-seo-audit (Claude Code skills docs).

claude.ai

Zip each skill folder and upload it as a custom skill. Anthropic lists custom skills on the Pro, Max, Ultra, Team and Enterprise plans with code execution enabled.

Connect the store

Connect Shopify in Ryze AI, then add https://connector.get-ryze.ai/mcp to Claude. The Shopify MCP page lists the 5 Shopify tools, and the Claude Code guide covers the terminal setup.

Skills uploaded to claude.ai do not reach the API, and skill folders saved in Claude Code do not upload to claude.ai. Anthropic advises using skills only from sources you trust, so read a skill before you save it. More free skills are in the Claude skills library.

Audit skills: read the catalog and orders

These four only read. They give you a list to act on and change nothing in the store.

01. Product SEO audit

Reads the SEO title and description of each product and flags the empty ones and the ones that repeat the product title word for word.

SKILL.md
--- name: shopify-product-seo-audit description: Audits product SEO titles and descriptions in a Shopify store. Use when asked which products lack SEO fields or have weak ones. --- # Shopify product SEO audit Tool: shopify__read (Admin GraphQL query, no mutations) - Object: products, 50 per page, status ACTIVE only - Fields: id, title, handle, seo { title description }, productType Steps: 1. List products where seo.title or seo.description is empty. 2. Flag SEO titles identical to the product title. 3. Flag SEO descriptions that repeat across products. Output: a table of product, handle and the problem, empty fields first. Do not edit anything.

Use it when: you inherited a catalog or imported products in bulk.

02. Collection SEO audit

Checks collection pages, which often rank for category searches, for empty SEO fields and thin descriptions.

SKILL.md
--- name: shopify-collection-seo-audit description: Checks Shopify collections for empty SEO fields and missing descriptions. Use when asked about collection page SEO. --- # Shopify collection SEO audit Tool: shopify__read - Object: collections - Fields: id, title, handle, seo { title description }, descriptionHtml, productsCount Steps: 1. Flag collections with an empty seo.title, empty seo.description or empty descriptionHtml. 2. Sort by productsCount, largest first. Output: a table ordered by productsCount with the missing fields per collection. Read only.

Use it when: you plan category page work and want the biggest collections first.

03. Catalog hygiene

Lists products that sit in draft or archived status, and active products with no product type or vendor.

SKILL.md
--- name: shopify-catalog-hygiene description: Finds draft and archived products and active products missing a type or vendor in Shopify. Use for catalog cleanups. --- # Shopify catalog hygiene Tool: shopify__read - Object: products - Fields: id, title, handle, status, productType, vendor, tags, updatedAt Steps: 1. Group products by status (ACTIVE, DRAFT, ARCHIVED). 2. In ACTIVE, list products where productType or vendor is empty. 3. In DRAFT and ARCHIVED, list the oldest updatedAt first. Output: three short lists with counts. Read only.

Use it when: you tidy the catalog before a season or a migration.

04. 60-day order recap

Summarizes orders from the last 60 days, the window Shopify allows without extra access, and the products that appear most.

SKILL.md
--- name: shopify-order-recap description: Recaps Shopify orders from the last 60 days and the products ordered most. Use for weekly or monthly store summaries. --- # Shopify 60-day order recap Tool: shopify__read - Object: orders, created_at filter inside the last 60 days - Fields: name, createdAt, displayFinancialStatus, currentTotalPriceSet { shopMoney { amount currencyCode } }, lineItems { title quantity } Steps: 1. Ask which date range inside the last 60 days to cover. 2. Count orders and sum currentTotalPriceSet per week. 3. List the line item titles with the highest total quantity. Output: a weekly table and a top-10 product list. State the date range used. If the user asks about older orders, say the connection only returns the last 60 days.

Use it when: you need a quick sales picture without opening the Shopify admin.

Content skills: check blogs and pages for stale text

Long articles and policy pages are where outdated text hides. These two use the search tool, which looks inside one text field and returns matching lines with line numbers and surrounding context, so Claude does not have to pull whole article bodies into the chat.

05. Blog article check

Finds articles that still mention a phrase you list, such as an old shipping window, a retired product or last year's date.

SKILL.md
--- name: shopify-blog-article-check description: Finds Shopify blog articles that contain outdated phrases the user lists. Use when asked to audit or refresh blog content. --- # Shopify blog article check Ask the user for the phrases to look for (for example a year, a product name or a policy term). Tools: 1. shopify__read: blogs, then articles with id, title, handle, publishedAt 2. shopify__search_content: search the body field of each article for each phrase Output: a table of article title, handle, matching line and line number. Group by phrase. Read only.

Use it when: a product line or policy changed and the blog may still describe it.

06. Page check

Runs the same search over store pages such as shipping, returns, sizing and about.

SKILL.md
--- name: shopify-page-check description: Searches Shopify store pages for stale or conflicting text. Use for policy page reviews. --- # Shopify page check Tools: 1. shopify__read: pages with id, title, handle, updatedAt 2. shopify__search_content: search the body of each page for the phrases the user gives Steps: 1. List pages by oldest updatedAt first. 2. For each phrase, report the page, line number and the line. 3. Flag two pages that give different values for the same policy, such as return days. Output: a table of page, line and conflict. Read only.

Use it when: you update shipping or return terms and want every page that mentions them.

Edit skills: change SEO fields, text and the catalog

These four write to the store. Each skill tells Claude to show a before and after table and wait for your go-ahead, which keeps a bulk change reviewable. That instruction lives in the skill, so it is only as strong as the model following it. For a hard stop, use the tool permissions in the safety section below.

07. SEO field rewrite

Writes new SEO titles and descriptions for products you pick, 10 at a time.

SKILL.md
--- name: shopify-seo-field-rewrite description: Rewrites SEO titles and descriptions for chosen Shopify products. Use after a product SEO audit. --- # Shopify SEO field rewrite Input: product handles from the user, or the problem list from shopify-product-seo-audit. Steps: 1. shopify__read: title, handle, descriptionHtml and seo for each product. 2. Draft an SEO title under 60 characters and a description under 160 from the product's own text. Do not invent specs, materials or claims. 3. Show a table: handle, old values, new values. Wait for the user to say go. 4. shopify__write: productUpdate with the seo fields, 10 products per batch. 5. shopify__read the same products and confirm the new values. Output: the confirmed values per handle.

Use it when: the SEO audit found empty or duplicate fields.

08. Find and replace

Fixes one phrase in a long description, page or article without rewriting the whole field.

SKILL.md
--- name: shopify-find-and-replace description: Replaces one phrase inside Shopify product descriptions, pages or blog articles. Use for policy, date or naming fixes. --- # Shopify find and replace Ask for the exact old text, the new text and the object type (product, page or article). Steps: 1. shopify__search_content: find every match and list the object, line number and context. 2. Show the list and wait for the user to say go. Skip any match the user excludes. 3. shopify__edit_content: replace the text inside that one field. 4. shopify__search_content again for the old text and report any match left. Output: a list of changed objects and the check result.

Use it when: a product was renamed or a policy number changed across many descriptions.

09. Collection SEO rewrite

Fills empty SEO fields on collections, starting with the ones that have the most products.

SKILL.md
--- name: shopify-collection-seo-rewrite description: Writes SEO titles and descriptions for Shopify collections. Use after a collection SEO audit. --- # Shopify collection SEO rewrite Steps: 1. shopify__read: collections with title, handle, descriptionHtml, seo, productsCount. 2. Draft seo.title under 60 characters and seo.description under 160 from the collection's own text and product titles. Do not add claims the store does not make. 3. Show handle, old values and new values. Wait for the user to say go. 4. shopify__write: collectionUpdate with the seo fields. 5. shopify__read the collections and confirm. Output: confirmed values per handle.

Use it when: the collection audit shows empty fields on high-traffic categories.

10. Cleanup candidates

Builds a delete list of old drafts and archived products and removes only the ones you name.

SKILL.md
--- name: shopify-cleanup-candidates description: Lists old draft and archived Shopify products and deletes only the ones the user confirms by handle. Use for catalog cleanup. --- # Shopify cleanup candidates Steps: 1. shopify__read: products with status DRAFT or ARCHIVED, with handle, title and updatedAt. 2. Show them oldest first. Do not call shopify__delete yet. 3. The user replies with the handles to remove. 4. Repeat the handles back and ask for a final yes. 5. shopify__delete: productDelete once per confirmed handle. 6. shopify__read to confirm the handles are gone. Never delete an ACTIVE product. Output: deleted handles and any that remain.

Use it when: you remove abandoned drafts after a launch.

How to run the skills on a live Shopify store

The Ryze AI connector gives Claude 5 Shopify tools. The read and search tools only read, the write tools create and update, and delete sits in its own tool:

  1. shopify__read

    What it does
    Runs a read-only Admin GraphQL query against the connected store
    Used by
    Skills 01 to 07, 09, 10
  2. shopify__search_content

    What it does
    Searches one text field, such as an article body, and returns matching lines with line numbers and context
    Used by
    Skills 05, 06, 08
  3. shopify__write

    What it does
    Runs a GraphQL mutation that creates or updates resources, such as productUpdate or metafieldsSet; delete-type mutations are rejected
    Used by
    Skills 07, 09
  4. shopify__edit_content

    What it does
    Makes find-and-replace edits inside one text field on the server, with optional JSON or Liquid validation
    Used by
    Skill 08
  5. shopify__delete

    What it does
    Runs a destructive mutation such as productDelete or tagsRemove
    Used by
    Skill 10

Connect the store from Integrations in Ryze AI: type your .myshopify.com domain, click Continue and approve the access prompt in Shopify admin. No API keys are needed on the default connection (Ryze AI help center). Then add https://connector.get-ryze.ai/mcp as a custom connector in Claude and start a new chat. If you add a platform after the connector, remove and re-add the connector so the tool list refreshes.

Some things need your own custom app instead of the default connection: theme file edits, URL redirects and customer records. Orders older than 60 days stay hidden unless the custom app has the read_all_orders scope, which Shopify says extends read_orders to older orders. Skills 01 to 10 stay inside what the default connection covers. Customer, inventory and discount data are not part of these skills.

With several stores in one workspace, the agent uses the primary store unless you name another, and the Shopify tools accept an optional connection_id. A store can be live in only one Ryze AI workspace at a time. Other Shopify servers are compared in best MCP for Shopify. Scheduled tasks and chat run inside the Ryze AI app too; plans are on the pricing page.

Keep write and delete skills under control

  • In Claude, open Customize > Connectors > Ryze AI > Tool permissions and set the write and delete tools to Needs approval. Every call to shopify__write, shopify__edit_content and shopify__delete then waits for you.
  • In the Ryze AI chat, the Tool approvals picker starts on Skip all approvals. Switch it to Approve write & delete, where reads run freely and changes need approval, or to Manual approve.
  • Batch size. The write skills here work on 10 products per batch so each approval covers a reviewable set.
  • Run reads first. Skills 01 to 06 give you the list; run 07 to 10 on a few handles before a whole catalog.

Claude can call connector tools in Research mode without further approval, according to Anthropic, so keep write skills out of Research runs.

Troubleshooting: when a Shopify skill returns a wrong answer

Claude has no Shopify tools

Claude keeps the tool list from when you added the connector. Remove and re-add it, then start a new chat (Ryze AI connector FAQ).

Orders stop two months back

Shopify returns orders from the last 60 days unless the app has read_all_orders. Skill 04 says so when you ask for older dates.

Missing scope error

The default connection does not request every scope. The agent reports the missing scope and does not work around it.

Theme or redirect edits fail

These need your own custom app, not the default connection.

A write call is refused

The write tool rejects delete-type mutations. Use skill 10, which calls the delete tool.

The store is already connected elsewhere

A store can be live in only one Ryze AI workspace at a time. Disconnect it from the other workspace first.

If an answer looks off, ask Claude to show the GraphQL query it sent.

Sources

The verdict

Turn each recurring store task into a skill with fixed objects and a fixed output. Start with the product SEO audit and the find-and-replace skill, run the read skills before the edit skills, and keep one-off questions as prompts.

Ryze AI runs these skills in Claude against a connected Shopify store. The default connection leaves out theme files, redirects and customer records, and orders stop at 60 days, so those tasks need your own custom app or the Shopify admin.

Frequently asked questions

What are Claude skills for Shopify?
SKILL.md files that tell Claude which Shopify objects to read or edit, which checks to run and how to present the result. Claude loads one when a request matches its description, so a check such as a product SEO audit runs the same way each time.
Do I need a store connection to use these skills?
The read skills also work on an export you attach if it has the fields the skill names. Skills that edit or delete need a connection, because they call the write, edit and delete tools.
Which Claude plan do I need?
Anthropic lists custom skill uploads on claude.ai for Pro, Max, Ultra, Team and Enterprise with code execution enabled. In Claude Code, skills are folders on your computer. For the connector, Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise, with Free limited to one.
What is the best way to run these on live store data?
Use the Ryze AI connector: one URL gives Claude 5 Shopify tools for reading, searching, writing, editing and deleting. The default connection has no theme file edits, redirects or customer records, and it returns orders from the last 60 days only.
Show 7 more questions
Can Claude delete products through these skills?
Yes, through the separate shopify__delete tool, which skill 10 uses. The write tool rejects delete-type mutations. Set write and delete tools to Needs approval in Claude so each call waits for you.
Do the skills ask for approval before editing?
The skill text tells Claude to show a before and after table and wait for your go-ahead. For an enforced stop, set the write and delete tools to Needs approval under Customize > Connectors > Ryze AI > Tool permissions. In the Ryze AI chat, the approvals picker starts on Skip all approvals.
How far back can the order recap look?
60 days on the default connection. Shopify's read_orders scope covers orders created within the last 60 days, and read_all_orders must be declared alongside it to reach older ones. Ryze AI documents that limit and the custom app route for it.
Can these skills edit my theme or redirects?
Not on the default connection. Theme file edits, URL redirects and customer records need a custom app connected in Ryze AI. None of the 10 skills depend on them.
Does Shopify have its own tool for AI agents?
Shopify publishes an AI toolkit with agent skills and a Dev MCP server. It gives coding agents Shopify docs and API schemas and does not connect to a store, so it suits app and theme development rather than store content work.
Can I use these with more than one store?
Yes. Several Shopify stores can sit in one workspace, and the agent uses the primary store unless you name another. A store can be live in only one Ryze AI workspace at a time.
How much does it cost?
Connecting the connector is free, and the tools need an active plan or trial. Paid Ads is $89 a month with a 7-day free trial, and annual billing takes 30% off the first year.

Related guides

Ryze AI: Shopify skills on a live store

7-day free trial, $89 a month flat

Start free trial