Shopify Theme Validator

    1

    Validate a Shopify theme before upload and catch the defects Shopify's own theme-check misses.

    $15

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    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 PathStatusDetails
    sections/product-info.liquidFAILED1 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 size to display_size to avoid Liquid filter collisions.
    • Run python3 validate.py sections/product-info.liquid again 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_url and its variants, recommending the current image_url standard.
    • Identifies Liquid collisions by warning about setting IDs like size, first, or last that 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

    1. Analyze theme files by pointing the tool at a specific Liquid/JSON file or an entire Shopify theme folder.
    2. Review validation report which lists errors (blocks that will fail upload) and warnings (logical or syntax risks) per file.
    3. Run automated fixes using the --fix command to resolve duplicate setting IDs and update their corresponding Liquid references.
    4. 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_data or hardcoded prices.
    • Mass-repairing duplicate setting IDs in legacy themes using the --fix utility.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listedtoday

    What's inside

    Frequently Asked Questions

    This skill targets 'silent' errors that official tools overlook, such as the 25-character limit for section names and reserved Liquid keywords (like 'size' or 'first') that cause schema collisions and upload failures.

    The skill includes a pre-configured validation engine and the '--fix' utility for automated repairs; it requires a Python 3 environment to execute the analysis on your theme files.

    Yes, the validator can be pointed at an individual Liquid or JSON file for quick checks, or an entire theme directory to audit global settings and template integrity across the whole project.

    The skill is optimized for Shopify's current JSON-based OS 2.0 architecture but remains fully compatible with legacy Liquid themes for identifying deprecated filters and schema errors.

    While it catches code-breaking schema errors and Liquid bugs, it is not a visual debugger; it does not check for CSS styling issues, browser compatibility, or storefront accessibility.

    New in E-commerce