Skip to content

[Community Submission] Add skill: variant-option-normalizer#70

Open
raqibdev wants to merge 14 commits intotimctfl:mainfrom
raqibdev:variant-option-normalizer
Open

[Community Submission] Add skill: variant-option-normalizer#70
raqibdev wants to merge 14 commits intotimctfl:mainfrom
raqibdev:variant-option-normalizer

Conversation

@raqibdev
Copy link
Copy Markdown
Contributor

@raqibdev raqibdev commented Apr 4, 2026

Description

Implement variant-option-normalizer skill: scans Shopify product CSVs for inconsistent option values, proposes canonical naming, and produces a corrected CSV with change log.

  • LLM + Script - hybrid architecture: a Python audit script handles deterministic checks (whitespace, case, duplicates, size ordering, missing images, option name drift) and outputs structured JSON; the LLM interprets findings, handles judgment calls, and manages the merchant conversation
  • Adds scripts/normalize_audit.py (Python 3.10+, stdlib only) with 8 detection categories and a structured JSON schema documented in references/json-schema.md
  • Adds assets/size_aliases.json and assets/option_name_aliases.json covering apparel letter, plus, infant, toddler, youth, petite, and tall size systems plus color alias groups
  • Updates SKILL.md to orchestrate the script-first workflow with LLM fallback if Python is unavailable
f926aad06623574ff0aa72bdb6a7364dc997b71165df27b8fa952ea03a8cff49 4a11d4182a240693a813f21070f6a9244709bec063c39ea49f46e2ee8ed89d0b 6f9ce1c5d56d55d7f59c4758f801417c6b2a0142332ea9a622c5023c7298ee4e

Test plan

  • Run python3 scripts/normalize_audit.py fixtures/greatoutdoorsco/shopify-products-messy-variants.csv --assets-dir assets/ and confirm 10 issues detected across all 8 categories
  • Run against fixtures/greatoutdoorsco/shopify-products.csv and confirm 16 issues with no false positives

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.

raqibdev added 14 commits April 5, 2026 01:32
- Introduced a new skill for normalizing and repairing variant options in Shopify product CSVs.
- Added detailed documentation outlining the skill's functionality, input requirements, and output format.
- Included an example output to demonstrate the skill's capabilities and expected results.
…data during row reordering in variant option normalizer
…tespace trimming, clarifying missing image checks, and adding reminders for Shopify import processes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant