neuro-shopify-seo

Implements technical SEO, structured data, and meta tags in Shopify Liquid theme files.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/webdevarif/claude-skills --skill neuro-shopify-seo-webdevarif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neuro-shopify-seo
Source: https://github.com/webdevarif/claude-skills/tree/main/neuro-shopify-seo
Command: npx skills add https://github.com/webdevarif/claude-skills --skill neuro-shopify-seo-webdevarif

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shopify themes often ship with missing canonical tags, duplicate content from variant and filter URLs, absent structured data, and unoptimized meta tags, causing poor search rankings and lost rich result eligibility. ## Core Features & Use Cases - Technical SEO Foundations: Enforces correct title tags, meta descriptions, canonical URLs, robots directives, hreflang, pagination rel links, and robots.txt.liquid customization in Liquid templates. - JSON-LD Structured Data: Provides ready-to-use schema markup for Product, BreadcrumbList, Organization, WebSite SearchAction, Article, FAQPage, CollectionPage, Review, HowTo, and VideoObject. - Social Meta Tags: Generates complete Open Graph and Twitter Card tags per template type (product, article, collection) with correct image sizing. - Use Case: When editing a product page section, apply the Product schema snippet with GTIN/MPN identifiers, aggregate ratings from metafields, and canonical rules so variant URLs never get indexed separately. ## Quick Start Audit my theme.liquid and main-product.liquid files and add the missing canonical tags, Product JSON-LD schema, and Open Graph meta tags.

Frequently Asked Questions about neuro-shopify-seo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add Product schema markup to a Shopify theme?

Add a JSON-LD script block in sections/main-product.liquid or a product-schema snippet that outputs the Product type with name, images, brand, sku, gtin, and an AggregateOffer containing per-variant Offer entries. Use Liquid json filters to escape values and validate the result with Google's Rich Results Test.

How to fix duplicate content from Shopify variant and filter URLs?

Point the canonical link tag to the base product or collection URL instead of variant or filtered URLs, and output noindex, follow robots meta tags when current_tags, filter, or sort_by parameters are present. This prevents parameter-heavy URLs from being indexed separately.

Does Shopify support custom robots.txt and hreflang tags?

Yes, Shopify lets you customize robots.txt through the robots.txt.liquid template, where you can add Disallow rules and per-locale sitemap references. Hreflang tags can be generated by looping over shop.published_locales and outputting alternate link tags per locale.

Should I lazy-load the main product image in Shopify?

No, the largest above-the-fold image should use loading="eager" and fetchpriority="high" because it is typically the LCP element measured by Core Web Vitals. Lazy-load only subsequent images, and always use the image_url filter so Shopify's CDN serves modern formats.

Why is AggregateRating schema risky on Shopify product pages?

Outputting AggregateRating without genuine review data violates Google guidelines and can trigger penalties or loss of rich results. Only render the rating schema when product.metafields.reviews.rating.value contains real review data from a reviews app or metafield source.