shopify-liquid

shopify-liquid is a skill for Claude Code, Codex from jonathanmoore/kona-theme. It costs 55 tokens per session (3,300 once invoked), scanned A, original, MIT.

A reference for Shopify Liquid, the template language used to build Shopify themes. It covers theme files, reusable parts, editor settings, translation keys, and Liquid syntax such as filters and tags.

In plain words
What is it for?
Use it while writing or editing .liquid files, Shopify theme schema settings, locale files, or code that uses Liquid objects, filters, and tags.
Why use it?
It helps avoid guessing how Shopify theme files and Liquid features are meant to work. It also clarifies when to use sections, blocks, snippets, layouts, and templates.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/jonathanmoore/kona-theme/shopify-liquid
Any agent
npx skills add jonathanmoore/kona-theme --skill shopify-liquid
Clone the repo
git clone --depth 1 https://github.com/jonathanmoore/kona-theme

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for shopify-liquid

README.md
[![agentmods](https://agentmods.dev/badge/skills/jonathanmoore/kona-theme/shopify-liquid.svg)](https://agentmods.dev/skills/jonathanmoore/kona-theme/shopify-liquid)
Your own site
<a href="https://agentmods.dev/skills/jonathanmoore/kona-theme/shopify-liquid"><img src="https://agentmods.dev/badge/skills/jonathanmoore/kona-theme/shopify-liquid.svg" alt="Measured on agentmods" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,300 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00055 $0.03300
Opus 5 $0.00028 $0.01650
Sonnet 5 $0.00011 $0.00660
Haiku 4.5 $0.00006 $0.00330

Measured 5d ago against content hash ef02f41e2376, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

shopify-liquid scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/shopify-liquid/SKILL.md · 328 lines

How it starts

The opening of the file, as written. The whole thing — 328 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Shopify Liquid Reference

Theme Architecture

sections/    # Full-width page modules with {% schema %} — hero, product grid, testimonials
blocks/      # Nestable components with {% schema %} — slides, feature items, text blocks
snippets/    # Reusable fragments via {% render %} — buttons, icons, image helpers
layout/      # Page wrappers (must include {{ content_for_header }} and {{ content_for_layout }})
templates/   # JSON files defining which sections appear on each page type
config/      # Global theme settings (settings_schema.json, settings_data.json)
locales/     # Translation files (en.default.json, fr.json, etc.)
assets/      # CSS, JS, images served via Shopify CDN

When to use what

Need Use Why
Full-width customizable module Section Has {% schema %}, appears in editor, renders blocks
Small nestable component with editor settings Block Has {% schema %}, can nest inside sections/blocks
Reusable logic, not editable by merchant Snippet No schema, rendered via {% render %}, takes params
Logic shared across blocks/snippets Snippet Blocks can't {% render %} other blocks

Liquid Syntax

Delimiters

  • {{ ... }} — Output (prints a value)
  • {{- ... -}} — Output with whitespace trimming
  • {% ... %} — Logic tag (if, for, assign) — prints nothing
  • {%- ... -%} — Logic tag with whitespace trimming

Operators

Comparison: ==, !=, >, <, >=, <= Logical: and, or, contains

Critical Gotchas

  1. No parentheses in conditions — use nested {% if %} instead
  2. No ternary — always use {% if cond %}value{% else %}other{% endif %}
  3. for loops max 50 iterations — use {% paginate %} for larger arrays
  4. contains only works with strings — can't check objects in arrays
  5. Snippets can't access outer-scope variables — pass them as render params
  6. include is deprecated — always use {% render 'snippet_name' %}
  7. {% liquid %} tag — multi-line logic without delimiters; use echo for output

Read the full file on GitHub · 328 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 328 lines · 55 tokens per session scan A ef02f41e2376

Subscribe to this mod's changes

shopify-liquid is a skill published in the GitHub repository jonathanmoore/kona-theme (6 stars, last pushed 3mo ago), licensed MIT. It adds 55 tokens to every session and 3,300 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.