[Community Submission] Add skill: audit-google-merchant-feed

[raqibdev]

Description

Adds the Audit a Google Merchant Feed skill — validates a Google Merchant Center XML feed against Google's product data specification, cross-references against a Shopify product export CSV, and produces a prioritized error report with Shopify-native fix instructions.

What's included

• SKILL.md — Conversation flow, output structure, edge cases, gotchas
• skillshelf.yaml — Catalog metadata, FAQ, input/output schema
• references/validate_merchant_feed.py — Python validation script (stdlib only, Python 3.10+)
• references/shopify-merchant-audit-rules.md — 17 audit rules across 3 severity tiers
• references/shopify-merchant-field-map.md — Complete Shopify CSV → Google Merchant attribute mapping
• references/example-output.md — Full example audit report using the Great Outdoors Co. fixture

How it works

1. Merchant uploads XML feed + Shopify CSV (optional but should be provide for accurate validation)
2. LLM runs validate_merchant_feed.py, which outputs structured JSON
3. LLM reads the JSON and produces a Markdown audit report with Shopify-specific fix instructions
4. Each finding is tagged as either a "Shopify data fix" or a "feed tool fix"

Audit rules (17 total)

Tier	Rules	What they catch
Disapproved (5)	D01–D05	Missing required attrs, duplicates, malformed HTML, prohibited content
Demoted (8)	W01–W05, W07–W10	Brand not in title, thin descriptions, broad categories, inconsistent variants, invalid GTINs, invalid attribute values
Advisory (4)	A01–A03, A05–A07	Missing sale price, no additional images, GTIN sync, product highlights, variant titles, shipping weight
Cross-ref (3)	X01–X03	Price mismatch, title mismatch, items missing from feed

Shopify-specific design decisions

• Fix instructions reference Bulk Edit, product editor, Google & YouTube channel — not "edit the XML"
• Pricing section explains Shopify's Variant Price / Variant Compare At Price swap vs Google's g:price / g:sale_price model
• D03 (duplicate IDs) explicitly warns against disconnecting the Google & YouTube channel
• GTIN validation uses modulo-10 check digit algorithm
• Cross-reference matching tries 4 strategies: MPN→SKU, ID→SKU, GTIN→Barcode, handle+options

Test plan

• Run python references/validate_merchant_feed.py fixtures/greatoutdoorsco/google-merchant-feed.xml fixtures/greatoutdoorsco/shopify-products.csv: verify JSON output
• Load SKILL.md into Claude with fixture data: verify report follows output structure
• Verify example-output.md matches the quality bar of existing skills

Contributor Attestation

• I agree to the Terms of Service and Privacy Policy, and I understand that if my submission is accepted it will be published under the Apache 2.0 license. I confirm I have the rights to submit this content and it does not include confidential information or personal data.