Skill Shopify para Agentes de IA
uppifyagency/Shopify-Development-Skill-for-AI-Agents
Documentação Shopify 1:1 verbatim como skill para agentes de IA — sem alucinações
Ver no GitHubSkill instalável que fornece toda a documentação oficial do Shopify (Liquid, temas, apps, Hydrogen, Functions) como base de conhecimento estruturada para Claude Code, Amp e Cursor. Elimina alucinações ao dar aos agentes acesso direto e rastreável à referência verbatim do shopify.dev, com índices para busca instantânea de 135+ objetos Liquid, 148+ filtros e documentação completa de temas.
Instalação
npx convez-ai uppifyagency/Shopify-Development-Skill-for-AI-Agents1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Desenvolvimento de temas Shopify com agentes IA
- Consulta de referência Liquid, filtros e tags durante codificação
- Implementação de Shopify Functions e apps customizados com base confiável
- Redução de hallucinations em geração de código Shopify
Veredito

Skill bem-construída e prática que resolve um problema real: agentes IA alucinando ao codificar Shopify. A abordagem de indexação estruturada e verbatim é sólida. Recomendado para equipes que automatizam desenvolvimento Shopify com Claude Code ou Cursor.
README
A tradução para o português deste README ainda está na fila.
Shopify Development Skill for AI Agents
Give Claude Code, Amp & Cursor the entire shopify.dev reference — so they look up Liquid, themes, apps, Hydrogen & Functions instead of hallucinating them.
A drop-in agent skill that turns the official Shopify developer docs into a navigable, 1:1 verbatim knowledge base your AI codes against.
Install · What's inside · How it works · Example · FAQ
🧠 The problem this solves
Ask any AI coding agent to write a Shopify theme section, a Liquid filter chain, or a Shopify Function and you hit the same wall: it invents Liquid filters that don't exist, guesses schema attributes, and mixes up Storefront vs Admin APIs. Shopify's surface is huge — Online Store themes, Liquid, custom apps, Hydrogen, Functions, metafields — and most of it post-dates the model's training cutoff.
This skill closes that gap. Instead of relying on memory, your agent reads the exact, verbatim Shopify documentation — captured 1:1 from shopify.dev and reorganized for instant lookup.
- "Use the | money_format filter…" ✗ hallucinated, doesn't exist
+ "Per indexes/liquid-filters.md → the ✓ verbatim, traceable
+ filter is | money, defined in ref/10"
✨ What you get
- 648 pages, 18 chapters, 1:1 verbatim — parameter tables, schemas and code examples kept exactly as Shopify wrote them. No summaries, no paraphrasing, nothing invented.
- Indexed for zero-context lookup — symbol indexes for 135 Liquid objects · 148 filters · 28 tags + a task router. The agent greps the right heading and reads only that slice, never the whole file.
- Full-surface coverage — themes & Liquid, theme JS APIs, custom apps & extensions, headless/Hydrogen, Shopify Functions, custom data, and AI/agentic commerce.
- Traceable — every reference page links back to its official
shopify.devsource. - Drop-in — one folder, copy it into your agent's skills directory, done. Works with Claude Code, Amp, Cursor and any agent that loads Markdown skills.
📦 What's inside
| Area | Coverage |
|---|---|
| Themes & Architecture | Layouts, JSON templates, sections, blocks, snippets, settings, config, locales — full schemas |
| Liquid Reference | 135 objects · 28 tags · 148 filters — signatures, parameters, examples |
| Theme APIs | Ajax cart API + Section Rendering API |
| Best Practices & Tooling | Performance, accessibility, Shopify CLI, Theme Check, GitHub workflow, Theme Store |
| Custom Apps & Extensions | OAuth & session tokens, App Bridge, webhooks, billing, Admin / Checkout / Customer-account / POS extensions |
| Headless & Hydrogen | Storefront API usage, Hydrogen, Oxygen, Customer Account API |
| Shopify Functions | Discounts, validation, cart transform, delivery & payment customization |
| Custom Data & AI | Metafields, metaobjects, agentic commerce (UCP / MCP, llms.txt / agents.md) |
Source:
shopify.dev, captured 2026-06-08. See the chapter map for the full breakdown.
⚡ Install
Claude Code
git clone https://github.com/uppifyagency/Shopify-Development-Skill-for-AI-Agents.git
cp -r Shopify-Development-Skill-for-AI-Agents/shopify-development ~/.claude/skills/
For a single project instead of globally, copy into <your-project>/.claude/skills/.
Amp
cp -r Shopify-Development-Skill-for-AI-Agents/shopify-development ~/.config/agents/skills/
Project-local: copy into .agents/skills/.
Cursor & other agents
Clone the repo into your project and point your agent at the skill — e.g. add a Cursor Rule that references shopify-development/SKILL.md, or @-mention the folder. Any agent that can read Markdown can use it.
Then just ask — "build me a Shopify product section with an image picker and color scheme" — and the agent auto-loads the skill on any Shopify task.
🔍 How it works
shopify-development/
├── SKILL.md # router: orientation + task-routing + lookup protocol
├── cheatsheet.md # one-page quick reference (file tree, Liquid, CLI, Ajax)
├── indexes/ # liquid-objects · liquid-filters · liquid-tags · schemas · task-routing
└── reference/ # 18 chapters, verbatim 1:1
- Install the folder into your agent's skills directory.
- The agent auto-loads
SKILL.mdthe moment a task touches Shopify. - It routes — identifies the surface (theme? Liquid? app? Hydrogen? Function?), looks the symbol up in an index to get the exact file + heading, then reads only that slice.
The result: answers grounded in the real docs, traceable to source, never guessed — and a small context footprint, because the agent never loads a whole reference file.
💡 Example
You: "Add a savings badge to my product card that only shows when the variant is on sale."
Without the skill, the agent guesses filter names and compare_at_price access patterns. With it, the agent:
- Routes to Liquid in a section →
indexes/liquid-objects.mdforvariant/product. - Confirms
variant.compare_at_priceand the| moneyfilter againstreference/07andreference/10— verbatim. - Writes correct Liquid the first time, with the schema setting wired in.
{% if variant.compare_at_price > variant.price %}
{% assign saved = variant.compare_at_price | minus: variant.price %}
<span class="badge">Save {{ saved | money }}</span>
{% endif %}
❓ FAQ
Partially, and unreliably — Liquid filters, schema attributes and the theme/app/Hydrogen split change faster than model training cutoffs. This skill gives the agent the verbatim docs to read instead of recalling, which is what stops the made-up | money_format-style filters.
They're complementary. The MCP server queries the live, auto-generated GraphQL/REST schemas (Admin, Storefront, Customer Account). This skill covers the conceptual + how-to + reference docs (Liquid, theme architecture, schemas, API usage, Functions, extensions) 1:1 — the parts MCP doesn't serve. Use both: skill for "how do I build this", MCP for "what's the exact GraphQL field". Every schema this skill deliberately omits is listed, with its URL, inside the relevant chapter.
Anything that loads a Markdown "skill" folder: Claude Code (~/.claude/skills/), Amp (~/.config/agents/skills/), and Cursor or others via rules / file references. It's plain Markdown — no runtime, no dependencies.
Yes. Once cloned, it's static Markdown on disk. No API calls, no network needed.
Captured from shopify.dev on 2026-06-08. The fast-moving AI/agentic chapter flags what was unverified at capture time. Re-pull the repo to get updates.
No. Uppify is an independent project, not affiliated with or endorsed by Shopify. The reference content is derived from Shopify's public developer documentation and remains © Shopify Inc.
🧭 Scope & limits
Covers the conceptual + how-to + reference (Liquid / schema / API-usage) docs 1:1. It intentionally does not dump the giant auto-generated GraphQL/REST schemas (Admin, Storefront, Customer Account), per-component Hydrogen/Polaris/Checkout-UI reference, or the full webhook-topic enum — those change often and are best queried live via the Shopify Dev MCP server. Every omitted reference is listed (with its URL) inside the relevant chapter's ## Pagine aggiuntive section.
🤝 Contributing & support
Found a stale page or a gap? Open an issue or a PR.
If this saves your agent from one hallucinated Liquid filter, give it a ⭐ — it helps other Shopify developers find it.
Questions or work with us → email.vlad.vrinceanu@gmail.com
📄 License & attribution
The skill structure, indexes and navigation are released under the MIT License. The documentation content under shopify-development/reference/ is derived from Shopify's developer documentation (shopify.dev) and remains © Shopify Inc.; every page links to its official source. See NOTICE. Uppify is an independent project and is not affiliated with or endorsed by Shopify.
Built by Uppify · An AI knowledge skill for Shopify development
Shopify theme development · Liquid template language · Shopify app development · Hydrogen headless commerce · Shopify Functions · metafields & metaobjects · Shopify CLI · Online Store 2.0 · Claude Code skill · Amp skill · Cursor · AI coding agents