- Home
- Skills
- E-commerce
- shopify-theme-validator
Shopify Theme Validator
Validate a Shopify theme before upload and catch the defects Shopify's own theme-check misses.
$15
Works with the AI Agents you already use
shopify-theme-validator
Example session with this skill installed
Validate the sections/product-info.liquid file and check if it has any schema errors or long names that might break the shopify upload.
- Read your context and instructions
- Compiled the shopify-theme-validator
I have scanned sections/product-info.liquid against the Shopify Theme Validator rule set. The file contains one critical error that will prevent the template from saving correctly in the Shopify editor.
Validation Results
| File Path | Status | Details |
|---|---|---|
sections/product-info.liquid | FAILED | 1 Error, 1 Warning found. |
Errors Found:
Block Name Limit: The block type upsell_product_announcement has a name "Special Upsell Product Selection" which is 31 characters. Shopify enforces a strict
25-character maximum. This will cause the theme to silently drop associated template files on upload.
Warnings Found:
Liquid Filter Collision: A setting ID is named size. This will collide with the Liquid | size filter. If section.settings.size is missing, Liquid will return a character count of the object instead of an empty value.
Corrected Schema Fragment:
{
"name": "Product Info",
"blocks": [
{
"type": "upsell",
"name": "Upsell Product",
"settings": [
{
"type": "product",
"id": "product",
"label": "Product"
},
{
"type": "text",
"id": "display_size",
"label": "Display Size"
}
]
}
]
}
Next steps
- Shorten the block name from "Special Upsell Product Selection" to "Upsell Product" (14 chars).
- Rename the setting ID
sizetodisplay_sizeto avoid Liquid filter collisions. - Run
python3 validate.py sections/product-info.liquidagain to verify the fix.
Connects securely to your tools. The creator never sees your data.
About this skill
Shopify theme uploads often fail silently or drop files without clear error messages. This usually happens because of strict character limits, deprecated filters, or schema collisions that standard tools like Shopify Theme-check do not detect. This skill provides a specialized validator that catches the specific defects that break theme saves and prevents broken files from going live.
What it does
- Enforces schema limits by checking that section and block names stay under the 25-character limit to prevent silent upload failures.
- Audits setting IDs for duplicates within individual settings arrays across sections, blocks, and the global settings schema.
- Flags deprecated filters specifically targeting
img_urland its variants, recommending the currentimage_urlstandard. - Identifies Liquid collisions by warning about setting IDs like
size,first, orlastthat conflict with built-in Liquid filters. - Validates template integrity by ensuring all referenced section files exist and all block types used in templates are defined in the schema.
- Cleans placeholder data by detecting hardcoded prices, currency, and common "sample" strings that should not reach shoppers.
How it works
- Analyze theme files by pointing the tool at a specific Liquid/JSON file or an entire Shopify theme folder.
- Review validation report which lists errors (blocks that will fail upload) and warnings (logical or syntax risks) per file.
- Run automated fixes using the
--fixcommand to resolve duplicate setting IDs and update their corresponding Liquid references. - Deploy with confidence after ensuring the validator returns an "OK" status for all core files.
Frameworks & tools
Python 3, Shopify Liquid, and Shopify Theme JSON schemas. Optionally uses Node.js for JavaScript syntax verification.
Why this beats prompting it yourself
Generic prompts often miss the specific character-count nuances and silent failure modes unique to Shopify's ingestion engine. This skill applies a pre-defined set of "Hard Rules" derived from real-world theme development failures that even the official theme-check misses.
Use cases
- Validating a theme ZIP before submitting it to a client or the Shopify Theme Store.
- Debugging "Invalid Block" or "Schema Name too long" errors during theme development.
- Preventing silent production bugs caused by unescaped
structured_dataor hardcoded prices. - Mass-repairing duplicate setting IDs in legacy themes using the
--fixutility.
Known limitations
This is a code validator, not a visual regression tool. It does not check for CSS layout issues or accessibility and requires Python 3 to run the automated script.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for E-commerce.
Requires Python 3. Cross-file checks require all related files to be passed in the same run. Fixer does not support bracket-notation settings. Code-level only; no visual or CSS auditing.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed today
- Software
Python