product-data-modeling

Design product catalog schemas with variants, attributes, metafields, and relationships for ecommerce platforms.

3|1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill product-data-modeling-tomtoto757
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-data-modeling
Source: https://github.com/tomtoto757/ecomm-ai-team/tree/main/skills/catalog-inventory/finsilabs/catalog-inventory/product-data-modeling
Command: npx skills add https://github.com/tomtoto757/ecomm-ai-team --skill product-data-modeling-tomtoto757

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Structuring a product catalog incorrectly causes data quality problems, import failures, and variant explosion. This Skill guides you through fitting your catalog into your platform's native data model — Shopify's products/variants/metafields, WooCommerce's attributes/variations, BigCommerce's options/SKUs — or designing a custom PostgreSQL schema for headless storefronts. ## Core Features & Use Cases - Platform-Specific Modeling: Step-by-step guidance for Shopify (options, variants, metafields), WooCommerce (product types, global attributes, variations), and BigCommerce (option sets, custom fields, modifiers). - Custom Headless Schema: Complete PostgreSQL schema with products, variants, options, JSONB attributes, and relationship tables, plus matching TypeScript types. - Relationship Planning: Configure upsells, cross-sells, and related products to increase average order value. - Use Case: When migrating a clothing catalog with size and color variants from a PIM into Shopify, use this Skill to decide which attributes become variants versus metafields and avoid hitting the 100-variant cap. ## Quick Start Ask the AI to design a product data model for your catalog on Shopify, WooCommerce, BigCommerce, or a custom PostgreSQL backend, including variants, attributes, and product relationships.

Frequently Asked Questions about product-data-modeling

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

FAQPage Schema
How do I model product variants in Shopify?▼

Shopify products support up to 3 options (e.g., Size, Color, Material) generating up to 100 variants, each with its own price, SKU, inventory, and weight. Use metafields for attributes that don't affect price or stock, such as care instructions or certifications.

What is the difference between product attributes and variants in WooCommerce?▼

In WooCommerce, global attributes defined under Products → Attributes become variation axes on Variable products, each with unique price, SKU, and stock. Non-variation custom attributes or ACF fields store data like technical specs that don't generate separate purchasable combinations.

Should I store prices as floats in a product database?▼

No, store prices as NUMERIC(10,2) in PostgreSQL or as integer cents in application code to avoid floating-point rounding errors. A price of $29.99 stored as 2999 cents eliminates display and calculation bugs common with FLOAT columns.

How do I handle more than 3 product options in Shopify?▼

Shopify caps products at 3 options and 100 variants. Combine two dimensions into one option (e.g., "Size/Width"), move the fourth dimension to metafields, or split fundamentally different items into separate product records.

When should I use EAV versus JSONB for custom product attributes?▼

Use JSONB columns with a GIN index for flexible attributes in most custom builds, since it avoids expensive EAV joins. Reserve full EAV normalization for cases requiring typed attribute definitions and strict per-attribute validation across many categories.

Why are my variant images not switching when a color is selected?▼

Variants need their own assigned image in the platform admin, not just the product-level image, to trigger the storefront swap. Assign variant-specific images per color option and verify all purchasable combinations in the variant selector before launch.