DEV Community

Eli
Eli

Posted on

A Shopify AI agent needs Skills, not one giant prompt

Most attempts at "an AI for my Shopify store" die in one of two ways.

The first is the giant prompt: a single system prompt that tries to be a merchandiser, a support rep, an inventory planner, and an SEO consultant at the same time. It demos beautifully and falls apart the first time you ask it to do the same job two days in a row.

The second is the wall of buttons: a dashboard of automations that can technically touch a live store — which is exactly why nobody with a real store dares to switch them on.

I've been iterating on a public artifact called the Shopify Growth Operator agent, and the thing that made it genuinely useful wasn't a smarter prompt. It was splitting the job into Skills — the way you'd split responsibilities across an operations team — and being strict about which of those Skills are allowed to change anything.

The wrong mental model: "a chatbot for my store"

When people hear "AI agent for e-commerce," the default picture is a customer-facing support bot. That's the wrong frame for an independent Shopify store, for two reasons.

First, the person who actually needs leverage is the owner. A one- or two-person store runs on a single human who is simultaneously the merchandiser, the CX team, the inventory planner, and the SEO person. The chat widget on the storefront is the least of their problems.

Second, a bot that talks to your customers is a liability surface. An agent that works for you is a productivity surface. So the Growth Operator is deliberately owner-facing: it reads store data, diagnoses problems, drafts changes and replies, and flags risks. Shopify stays the system of record — the agent never becomes a second source of truth, and it never fronts your customers.

What the job actually looks like

Before listing skills, it's worth stating what running a store day-to-day actually is. Every morning asks the same questions:

  • Is anything about to stock out?
  • Are any orders stuck in fulfillment?
  • Which of the thirty emails in the inbox actually matters?
  • Which product page is quietly underperforming?

And the meta-question that sits above all of them: given the hours I have today, what do I handle first?

A useful agent answers those questions every day, in the same structure, without being asked twice. That requirement — repeatable, structured, daily — is what pushes you away from one big prompt and toward discrete, versioned Skills.

The Skill stack

The current agent runs 19 Skills. Not one prompt with 19 sections — 19 separately maintained, separately testable units, grouped roughly like a team org chart:

Connection. shopify-admin-api-connector and api-graphql handle authentication, scopes, and the Admin GraphQL API. Boring and foundational; everything else sits on top. (There's a longer write-up on how the API connection works.)

Morning routine. daily-ops-checklist runs the recurring health check; daily-store-growth-digest turns yesterday's numbers into a short brief. The daily checklist is the closest thing the agent has to a heartbeat.

Diagnostics. shopify-store-diagnostics for the general check-up, plus shopify-performance-audit and shopify-cro-audit for speed and conversion specifically.

Risk. inventory-fulfillment-risk-monitor watches for stockouts and stuck fulfillments — the two problems that hurt most when you notice them late.

Inbox. customer-inbox-triage sorts incoming mail by urgency and drafts replies (drafts — more on that below). inbox-product-feedback-loop closes the loop: recurring complaints become proposed product-page fixes instead of vanishing into an archive folder.

Product pages. product-page-optimizer works on how a page reads and converts; shopify-product-serp-optimizer on how it appears in search results.

Search and compliance. shopify-seo-structured-data for schema markup, ai-search-readiness-audit and audit-website-aeo for machine-readability (scope note below), shopify-gmc-misrepresentation-auditor for Google Merchant Center risk, and shopify-markets-localization-auditor for multi-market consistency.

Automation planning. flow-vs-agent-planner, which decides what shouldn't be an agent job at all.

Content. social-content-engine drafts social posts from products and store events.

Eleven of these are purpose-built; eight are adapted from external skill kits. That mix is part of the argument: skills compose, and you shouldn't rebuild what the ecosystem already audits well.

The two behaviors that actually matter

After running this setup for a while, the most valuable things the agent does turn out to be boring:

It decides what comes first. The morning digest doesn't end with a data dump; it ends with a short, ordered list: handle this fulfillment exception, then this low-stock SKU, then this email. Prioritization is the product. Everything else is input.

It stops. Refunds, order cancellations, address changes, inventory adjustments, price changes, discount codes, customer-facing replies, publishing product pages, shipping settings — none of that executes without explicit owner approval. The agent prepares the change, states its reasoning, and waits.

The second behavior is what makes the first one trustworthy. An agent that can silently mutate a live store is something you have to check up on. An agent that drafts and waits is something you can actually delegate to. The approval gate isn't a limitation bolted on for safety optics — it's the feature that lets a store owner stop re-reading everything the agent produces.

What shouldn't be an agent at all

One Skill exists mostly to route work away from the agent. "If inventory drops below X, tag the product" doesn't need reasoning — it needs Shopify Flow: deterministic, instant, free. flow-vs-agent-planner looks at a proposed automation and answers whether it belongs in Flow, in the agent, or in the owner's own hands. A system that knows what it shouldn't do is cheaper and sturdier than one that tries to do everything.

An honest note on "AI search readiness"

The GEO/AEO skills audit one thing: whether your product pages, FAQs, spec tables, and policy pages are structured so that machine readers can extract them cleanly. That's the whole claim. They do not promise rankings, citations, or traffic — nobody can honestly promise that today, and a skill that pretended to would be selling weather forecasts.

Where this runs

The Skills themselves are markdown plus scripts, and the whole kit is open in the Shopify Growth Operator repo, with a fuller breakdown of each skill on the ClawMama blog. The agent runs on ClawMama, which handles the memory, scheduled runs, and approval flow around the Skills.

The updated agent is public: you can use the Shopify Growth Operator directly in Telegram or WhatsApp — the daily digest, triage summaries, and approval requests all arrive in the chat you already have open.

If you're building your own store agent instead, steal the structure, not the code: split the job by responsibility, gate every risky action behind the owner, and make the daily "what's first" brief the actual product.

Top comments (0)