Shopify Theme Validator
Coming soon
Shopify Theme Validator is a skill for Claude Code that checks a Shopify theme before you upload it, and catches the defects Shopify's own checks miss. Ask Claude Code to build a theme, and it usually makes a file that uploads with pieces missing. This skill stops that.
The problem
Files dropped on upload
A template that was in the ZIP is missing from the installed theme, with no error shown.
Save rejected
A section fails to save because a block name is one character too long.
Settings that clash
Two settings share one id, and the theme editor quietly uses the wrong one.
What it does
Shopify Theme Validator teaches Claude Code what to check before anything goes live:
- Every block and section name is checked against the 25-character limit before upload.
- Setting ids are checked for duplicates inside each settings list.
- Old image filters, hardcoded prices, and placeholder copy are flagged before shoppers see them.
- The premium pack can fix duplicate ids for you, and it never overwrites your files.
Two versions
Start free, or get the full pack.
Free skill
$0, free forever.
✓ The skill
✓ Install steps
✓ Hero example
✓ Validator checklist
Premium pack
$15, one-time.
✓ Everything in Free
✓ Theme validator (with fix)
✓ 6 sample sections
✓ Push-to-unpublished checklist
✓ CLI rescue toolkit
The validator
Before you upload, run the validator on the theme. It checks section and block schemas, template files, and Liquid files for the defects that break uploads and saves. If it finds a problem, it tells you which one and where. A theme that passes is ready to upload.
premium/references/hero-banner.liquid: OK: no errors, no warnings
Example output from the validator on a clean section.
No live-store upload test has been run. The sample files have never been installed on a live store. The premium pack includes a checklist for pushing to an unpublished theme and previewing there first.
How it works
Install the skill
Add the free skill to Claude Code, Codex, or Cursor, following the install steps on GitHub.
Build with Claude Code
Ask it to build or edit a theme. The skill keeps the files in a shape Shopify accepts.
Check, then upload
Run the validator on the theme, fix anything it flags, then push to an unpublished theme and preview it first.
Questions
Do I need Claude Code?
The skill is written for Claude Code, and it also works with Codex and Cursor.
Does it teach theme building?
No. It only validates. It checks a theme for the defects that break uploads and saves, and reports them before anything goes live.
What if an upload still drops files?
Run the validator again on the theme. It catches the usual causes, and the rescue toolkit walks through the CLI steps.
What does the license cover?
One person, on your own computers, including client work. The premium files are not for resale or sharing.
Get it
Premium pack, $15, one-time. Coming soon here. The free skill is on GitHub now.