Skill: leooooooow/size-guide-builder (version 1.1.0)

--- name: Size Guide Builder description: Create accurate, visual product sizing guides for apparel, footwear, and accessories that reduce size-related returns by including measurement instructions, fit notes, brand-specific conversion tables, and body-type recommendations. --- # Size Guide Builder Build comprehensive, accurate product sizing guides that reduce size-related returns, improve customer confidence, and increase conversion rates for apparel, footwear, and accessory ecommerce stores. ## Quick Reference | Decision | Strong | Acceptable | Weak | |----------|--------|------------|------| | Measurement system | Dual units (in/cm) with toggle | Single system matching store locale | Only one system, no locale awareness | | Size conversion | Brand-specific tables with source attribution | Generic international conversion chart | No conversion or unsourced tables | | Fit description | Quantified fit notes ("runs 0.5 size small") | Qualitative fit guidance ("runs small") | No fit guidance at all | | Body-type guidance | 3+ body types with specific recs | General "if between sizes, size up" | No body-type consideration | | Measurement instructions | Step-by-step with landmark references | Text-only instructions | "Measure yourself" with no detail | | Visual aids | Illustrated measurement diagrams described | Text with measurement point names | No visual guidance | | Return-rate impact | Tracks return reasons and updates guide | Static guide reviewed quarterly | Published once, never updated | | Mobile presentation | Responsive tables, swipeable comparisons | Readable on mobile | Desktop-only layout | ## Solves 1. **High return rates from size mismatches** — Customers order wrong sizes because product pages lack detailed measurement data, costing 20-30% in avoidable returns. 2. **Inconsistent sizing across brands** — Multi-brand stores confuse customers when a Medium from Brand A fits like a Large from Brand B. 3. **Missing international conversions** — Global customers cannot translate US/UK/EU sizes, leading to abandoned carts. 4. **No fit context for different body types** — Generic size charts ignore that the same measurements fit differently on different body shapes. 5. **Poor measurement instructions** — Customers measure incorrectly (e.g., measuring over clothes, using wrong landmarks), producing inaccurate size selections. 6. **Incomplete category coverage** — Stores have guides for tops but not bottoms, shoes, or accessories like rings and hats. 7. **Static guides that drift from inventory** — Size guides are published once and never updated when new brands or product lines are added. ## Workflow ### Step 1: Gather Product and Category Context Collect the following from the user: - **Product category**: Apparel (tops, bottoms, dresses, outerwear), footwear, accessories (hats, belts, rings, gloves) - **Brand(s)**: Single brand or multi-brand store - **Target market**: Primary regions for international conversion (US, UK, EU, JP, KR, AU) - **Known fit issues**: Any existing customer feedback about sizing ("runs small," "narrow fit") - **Existing size data**: Current size charts, manufacturer specs, or fit sample measurements - **Store platform**: Shopify, WooCommerce, custom — affects output format If the user provides a product URL or product data, extract sizing information from it directly. ### Step 2: Define Measurement Points For each product category, identify the critical measurement points: **Tops & Outerwear:** - Chest/Bust (measured at fullest point, arms relaxed at sides) - Waist (natural waistline, narrowest point of torso) - Hip (fullest point, approximately 7-9 inches below waist) - Shoulder width (seam to seam across back) - Sleeve length (shoulder seam to wrist bone) - Body/torso length (highest point of shoulder to hem) **Bottoms:** - Waist (where the garment sits — may differ from natural waist) - Hip (fullest point) - Inseam (crotch seam to hem) - Outseam (waistband to hem) - Thigh (measured at widest point, 1 inch below crotch) - Rise (front rise: waistband center to crotch seam) **Footwear:** - Foot length (heel to longest toe, in mm) - Foot width (ball of foot, widest point) - Width designation (Narrow/N, Medium/M, Wide/W, Extra Wide/XW) **Accessories:** - Hats: Head circumference (measured 1 inch above ears) - Belts: Waist measurement + 2-inch add rule - Rings: Inner circumference or diameter (mm) - Gloves: Hand circumference at knuckles (exclude thumb) ### Step 3: Build the Size Table Construct the size table with these requirements: 1. **Row structure**: One row per size (XS, S, M, L, XL, XXL — or numeric sizes) 2. **Column structure**: Size label | each measurement point | fit notes 3. **Dual units**: Show both inches and centimeters — format as "38 in / 96.5 cm" 4. **Range tolerance**: Use ranges for stretch or relaxed-fit items ("36-38 in") 5. **Brand-specific**: If multi-brand, create separate tables per brand with a comparison note 6. **Garment vs. body**: Clearly label whether measurements are "garment flat lay" or "body measurement" — this is the #1 source of confusion ### Step 4: Add Fit Context and Recommendations Layer qualitative guidance on top of the raw numbers: - **Fit type label**: Slim Fit / Regular Fit / Relaxed Fit / Oversized — with a one-line definition - **"Between sizes" rule**: Specific advice (e.g., "If between sizes, size up for layering; stay true for a fitted look") - **Body-type guidance**: At minimum address 3 common scenarios: - Athletic/muscular build → may need to size up in chest/thigh - Petite frame → check garment length, may need shorter inseam - Plus size → check that hip measurement is covered, not just waist - **Fabric/stretch note**: "This item has 5% elastane — measurements reflect un-stretched garment. Fabric stretches approximately 1-2 inches." - **Model reference** (if available): "Model is 5'10", 155 lbs, wearing size M" ### Step 5: Create Measurement Instructions Write clear, step-by-step self-measurement instructions: 1. Use a flexible measuring tape (not a ruler or metal tape) 2. Measure over light undergarments, not over bulky clothing 3. Stand naturally — do not suck in or puff out 4. Have someone help for back measurements (shoulder width, back length) 5. Measure each point 2 times and use the larger number 6. For each measurement point, specify the anatomical landmark precisely ### Step 6: Format International Conversions Create a conversion section covering: - US, UK, EU standard size equivalents - JP and KR sizes (if target market includes Asia) - AU/NZ sizes (offset from UK by specific rules per category) - Note any brand-specific deviations from standard conversions - Clearly mark "approximate" — no international standard is perfectly uniform ### Step 7: Compile and Quality-Check the Guide Assemble all sections and verify: - Every size in the product catalog is represented - Measurements are internally consistent (e.g., M is between S and L in all dimensions) - Dual units are mathematically correct (1 inch = 2.54 cm) - Fit notes match known customer feedback - Conversion tables are sourced and attributed - Guide is complete enough that a customer can self-select the right size without contacting support ## Example 1: Women's Casual T-Shirt **User input:** "I need a size guide for our women's relaxed-fit cotton t-shirts. We sell in US, UK, and EU. Customers say they run slightly large. The fabric is 100% cotton, pre-shrunk, no stretch." **Output:** ### Women's Relaxed Fit Tee — Size Guide **Fit:** Relaxed — designed to drape loosely with 2-3 inches of ease through the body. If you prefer a more fitted look, consider sizing down one size. **Fabric note:** 100% pre-shrunk cotton. No stretch. Measurements reflect garment laid flat, doubled for circumference. | Size | US | UK | EU | Chest | Waist | Body Length | Shoulder | |------|----|----|-----|-------|-------|-------------|----------| | XS | 0-2 | 4-6 | 32-34 | 34-35 in / 86-89 cm | 26-27 in / 66-69 cm | 24.5 in / 62 cm | 14 in / 35.5 cm | | S | 4-6 | 8-10 | 36-38 | 36-37 in / 91-94 cm | 28-29 in / 71-74 cm | 25 in / 63.5 cm | 14.5 in / 37 cm | | M | 8-10 | 12-14 | 40-42 | 38-39 in / 96.5-99 cm | 30-31 in / 76-79 cm | 25.5 in / 65 cm | 15 in / 38 cm | | L | 12-14 | 16-18 | 44-46 | 40-42 in / 101.5-107 cm | 32-34 in / 81-86 cm | 26 in / 66 cm | 15.5 in / 39.5 cm | | XL | 16-18 | 20-22 | 48-50 | 43-45 in / 109-114 cm | 35-37 in / 89-94 cm | 26.5 in / 67 cm | 16 in / 40.5 cm | | XXL | 20-22 | 24-26 | 52-54 | 46-48 in / 117-122 cm | 38-40 in / 96.5-101.5 cm | 27 in / 68.5 cm | 16.5 in / 42 cm | **Fit note:** This style runs slightly large. If you are between sizes or prefer a less oversized look, we recommend sizing down. **Body-type tips:** - *Athletic/broad shoulders:* Match your shoulder measurement first; the relaxed body will accommodate a larger chest. - *Petite (under 5'4"):* Consider XS or S regardless of normal size — check body length to ensure the hem hits at the right point. - *Fuller bust:* Size to your chest measurement; the relaxed waist will not be restrictive. **How to measure:** 1. **Chest:** Wrap the tape around the fullest part of your bust, keeping the tape level and snug but not tight. Arms at your sides. 2. **Waist:** Measure at your natural waistline — the narrowest point of your torso, usually just above your belly button. 3. **Shoulder:** Have someone measure across your back from the tip of one shoulder bone to the other. ## Example 2: Men's Running Shoes **User input:** "We need a size guide for our men's running shoes. We sell globally. The shoes are true to size with a medium-width last. Available in sizes US 7-14, including half sizes." **Output:** ### Men's Performance Running Shoe — Size Guide **Fit:** True to size on a medium-width (D) last. If you have wide feet, consider our Wide (2E) option or sizing up 0.5 size. **Measuring your foot:** 1. Stand on a piece of paper against a wall, heel touching the wall 2. Mark the tip of your longest toe (this may not be your big toe) 3. Measure from the wall to the mark in millimeters 4. Measure both feet — use the larger measurement 5. Measure at the end of the day when feet are slightly swollen | US | UK | EU | JP (cm) | KR (mm) | Foot Length (mm) | |----|----|----|---------|---------|-----------------| | 7 | 6 | 40 | 25.0 | 250 | 248-252 | | 7.5 | 6.5 | 40.5 | 25.5 | 255 | 253-257 | | 8 | 7 | 41 | 26.0 | 260 | 258-262 | | 8.5 | 7.5 | 42 | 26.5 | 265 | 263-267 | | 9 | 8 | 42.5 | 27.0 | 270 | 268-272 | | 9.5 | 8.5 | 43 | 27.5 | 275 | 273-277 | | 10 | 9 | 44 | 28.0 | 280 | 278-282 | | 10.5 | 9.5 | 44.5 | 28.5 | 285 | 283-287 | | 11 | 10 | 45 | 29.0 | 290 | 288-292 | | 11.5 | 10.5 | 45.5 | 29.5 | 295 | 293-297 | | 12 | 11 | 46 | 30.0 | 300 | 298-302 | | 13 | 12 | 47.5 | 31.0 | 310 | 308-312 | | 14 | 13 | 48.5 | 32.0 | 320 | 318-322 | **Width guide:** | Width | Description | Ball of Foot | |-------|-------------|-------------| | B (Narrow) | For narrow feet | < 95 mm | | D (Medium) | Standard width — this shoe | 95-105 mm | | 2E (Wide) | For wide feet | 106-115 mm | | 4E (Extra Wide) | For extra-wide feet | > 115 mm | **Tips:** - Running shoes should have a thumb's width (~10-12 mm) of space between your longest toe and the front of the shoe. - If you wear thick running socks, measure your foot while wearing them. - Orthotics users: remove the insole, place your orthotic inside, and check that your foot does not hang over the edges. ## Common Mistakes 1. **Confusing garment measurements with body measurements.** Always label which you are providing. A "38-inch chest" garment is designed for a body with a 36-inch chest (2 inches of ease). Mixing these up causes universal mis-sizing. 2. **Using only one measurement system.** International customers leave if they see only inches. Always provide dual units and verify the math (1 in = 2.54 cm, not 2.5). 3. **Providing a single generic chart for multiple brands.** A size M from one manufacturer is not the same as another. Multi-brand stores must provide brand-specific tables or at minimum note deviations. 4. **Ignoring the "between sizes" scenario.** Most customers fall between sizes. Without explicit guidance, they either buy two sizes (increasing returns) or abandon the cart. 5. **Skipping measurement instructions.** Customers who measure incorrectly will choose the wrong size even with a perfect chart. Always include how-to-measure steps. 6. **Forgetting to specify fit type.** "Regular fit" and "slim fit" produce completely different size recommendations from the same body measurements. Always state the intended fit. 7. **Not updating guides when products change.** Manufacturers adjust patterns and fabrics between seasons. A size guide from last year may be wrong for this year's inventory. 8. **Ignoring accessories.** Ring sizes, hat sizes, and belt sizes have their own measurement systems that are frequently omitted from stores that sell these alongside apparel. 9. **No mobile optimization.** Large tables are unreadable on phones. Recommend responsive table format or measurement-lookup tools. 10. **Omitting stretch/fabric composition.** A garment with 5% elastane fits dramatically differently from one with 0%. Always note fabric composition and its impact on fit. ## Resources - [Output Template](references/output-template.md) — Structured template for delivering size guides - [Sizing Standards Guide](references/sizing-standards-guide.md) — International sizing standards and conversion references - [Measurement Best Practices](references/measurement-best-practices.md) — Detailed measurement techniques and accuracy tips - [Quality Checklist](assets/quality-checklist.md) — Pre-delivery verification checklist

path: references/output-template.md
content: # Size Guide Output Template

Use this template to structure every size guide deliverable. Fill in each section based on the product data and user context gathered during the workflow.

---

## [Product Name] — Size Guide

### Fit Profile

- **Fit type:** [Slim Fit / Regular Fit / Relaxed Fit / Oversized]
- **Fit description:** [1-2 sentence description of how the garment is designed to fit]
- **Known fit notes:** [e.g., "Runs 0.5 size small" or "True to size"]

### Fabric & Stretch

- **Composition:** [e.g., 95% cotton, 5% elastane]
- **Stretch factor:** [None / Slight (1-2%) / Moderate (3-5%) / High (6%+)]
- **Measurement basis:** [Garment laid flat / Body measurement]
- **Care note:** [e.g., "May shrink 3-5% after first wash if not pre-shrunk"]

### Size Table

| Size | [Region 1] | [Region 2] | [Region 3] | [Measurement 1] | [Measurement 2] | [Measurement 3] | [Measurement 4] |
|------|-----------|-----------|-----------|-----------------|-----------------|-----------------|-----------------|
| [XS] | [0-2] | [4-6] | [32-34] | [XX in / XX cm] | [XX in / XX cm] | [XX in / XX cm] | [XX in / XX cm] |
| [S] | | | | | | | |
| [M] | | | | | | | |
| [L] | | | | | | | |
| [XL] | | | | | | | |
| [XXL] | | | | | | | |

### Between-Sizes Guidance

- **General rule:** [e.g., "If between sizes, size up for a relaxed fit; size down for a fitted look"]
- **Layering:** [e.g., "If you plan to layer underneath, size up one size"]
- **Shrinkage:** [e.g., "If fabric is not pre-shrunk, size up to account for 3-5% shrinkage"]

### Body-Type Recommendations

| Body Type | Recommendation |
|-----------|---------------|
| Athletic / Muscular | [e.g., "Size up one in chest; the waist will still fit due to relaxed cut"] |
| Petite (under 5'4") | [e.g., "Focus on body length — you may need a shorter size or petite option"] |
| Fuller Figure | [e.g., "Size to your largest measurement (usually hip); check that chest is also covered"] |
| Tall (over 6'0") | [e.g., "Check body/torso length; you may need a tall option or size up for length"] |

### How to Measure Yourself

1. **[Measurement Point 1]:** [Step-by-step instruction with anatomical landmark]
2. **[Measurement Point 2]:** [Step-by-step instruction]
3. **[Measurement Point 3]:** [Step-by-step instruction]
4. **[Measurement Point 4]:** [Step-by-step instruction]

**Tips:**
- Use a flexible measuring tape
- Measure over light undergarments
- Stand naturally — do not flex or suck in
- Measure twice, use the larger number
- Have someone help with back measurements

### International Conversion Table

| US | UK | EU | JP | KR | AU/NZ |
|----|----|----|----|----|-------|
| | | | | | |

**Note:** International sizes are approximate. Sizing standards vary between manufacturers even within the same country. When in doubt, refer to the measurement table above.

### Model Reference (if available)

- **Model height:** [e.g., 5'10" / 178 cm]
- **Model weight:** [e.g., 155 lbs / 70 kg]
- **Model measurements:** [e.g., Chest 38" / Waist 31" / Hip 39"]
- **Size worn:** [e.g., M]
- **Model fit note:** [e.g., "Fits true to size on our model with a slight oversized look through the torso"]

---

## Delivery Format Notes

- For **Shopify**: Output as HTML table with responsive CSS classes
- For **WooCommerce**: Output as shortcode-compatible HTML or plugin-specific format
- For **Custom platforms**: Output as clean markdown or structured JSON
- Always provide a plain-text fallback for email/support use


path: references/sizing-standards-guide.md
content: # International Sizing Standards Reference Guide

## Overview

This guide documents the major international sizing systems, their origins, and conversion rules. Use it as a reference when building size charts that serve global customers.

## Apparel Sizing Systems

### US Sizing (ASTM Standards)

US women's sizing uses even numbers (0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22) plus letter sizes (XS through XXL). US men's sizing uses chest measurements in inches for tops (S=34-36, M=38-40, L=42-44, XL=46-48) and waist measurements for bottoms (28, 30, 32, 34, 36, 38, 40).

Key facts:
- ASTM D5585 defines standard body measurements for misses figure types
- "Vanity sizing" has shifted US sizes down by approximately 2 sizes since the 1980s — a modern size 8 has measurements closer to a 1980s size 12
- Plus sizes typically start at 14W or 1X (equivalent to 14-16)
- Petite sizes have the same bust/waist/hip but shorter torso and inseam

### EU Sizing

EU sizing uses a numeric system based on body measurements in centimeters.

Women's formula: EU size = (bust in cm / 2) + 6. Example: 88 cm bust = (88/2) + 6 = 50, but in practice mapped to size 44 due to ease factors.

Common mapping:
- EU 34 = XS
- EU 36-38 = S
- EU 40-42 = M
- EU 44-46 = L
- EU 48-50 = XL

Men's mapping:
- EU 44-46 = S
- EU 48-50 = M
- EU 52-54 = L
- EU 56-58 = XL

### UK Sizing

UK women's sizes run 4 numbers higher than US sizes (US 6 = UK 10). UK men's sizes are similar to US for tops but use inch-based waist measurements for bottoms.

Conversion rule: UK women's = US women's + 4

### Japanese (JP/JIS) Sizing

Japanese sizing uses body height and bust/chest measurements:
- Women's: S (154-162 cm height, 78-82 cm bust), M (154-162, 82-86), L (154-162, 86-90)
- Men's: S (155-165, 82-86), M (165-175, 88-92), L (175-185, 96-100)

JIS standard (JIS L4005 for women, JIS L4004 for men) defines precise measurement ranges.

### Korean (KR) Sizing

Korean sizing uses a three-number system: height-chest-waist (e.g., 165-90-75). For consumer retail, simplified as:
- 44 (XS), 55 (S), 66 (M), 77 (L), 88 (XL)
- These numbers originally derived from bust circumference

## Footwear Sizing Systems

### US Footwear

Based on the Brannock Device system:
- Men's sizes start at 1 (child) and go to 16+
- Women's sizes are 1.5 sizes larger than men's (Women's 8 = Men's 6.5)
- Half sizes differ by 1/6 inch (4.23 mm) in length

### UK Footwear

Similar progression to US but offset:
- UK men's = US men's - 0.5 to 1 (varies by manufacturer)
- UK women's = US women's - 2

### EU Footwear (Paris Point)

Uses the Paris Point system: 1 Paris Point = 2/3 cm = 6.67 mm
- EU size = (foot length in cm + 1.5) × 1.5
- EU 40 = approximately 25.5 cm foot length

### Japanese Footwear (Mondopoint)

Japan uses centimeters directly:
- JP 25.0 = 25.0 cm foot length
- This is the most logical system — maps directly to foot measurement

### Korean Footwear

Korea uses millimeters:
- KR 250 = 250 mm = 25.0 cm = JP 25.0

## Accessory Sizing

### Ring Sizing

Major systems:
- US/Canada: Numeric (1-16, with half and quarter sizes)
- UK/Australia: Alphabetical (A-Z)
- EU: Inner circumference in mm (41-76)
- JP: Numeric (1-30), where JP 1 = 41 mm circumference

Conversion: US ring size = (circumference in mm - 36.5) / 2.55

### Hat Sizing

- US/UK: Fractional inches of head circumference (6 7/8, 7, 7 1/8...)
- EU/metric: Centimeters of head circumference (54, 55, 56, 57...)
- One-size-fits-most: Typically fits 56-60 cm (22-23.6 in)

### Belt Sizing

Universal rule: Belt size = waist measurement + 2 inches (5 cm)
- If waist is 32 inches, order a 34-inch belt
- Measure where you actually wear the belt, not your pant size

## Vanity Sizing Awareness

Vanity sizing (downsizing labels so customers feel good about a smaller number) varies dramatically between brands. Premium/luxury brands tend to size more generously (vanity down), while fast-fashion brands vary unpredictably.

Impact on size guides:
- Never assume Brand A's Medium = Brand B's Medium
- Always anchor to actual measurements, not size labels
- When possible, include a "compared to other brands" note

## Sources and Standards Bodies

- ASTM International — D5585, D6240, D6960 (US body measurement standards)
- ISO 8559 — Garment construction and body measurement procedures
- JIS L4005, L4004 — Japanese Industrial Standards for apparel
- EN 13402 — European standard for clothing sizes
- Brannock Device Co. — US/UK footwear sizing system


path: references/measurement-best-practices.md
content: # Measurement Best Practices for Ecommerce Size Guides

## Why Measurement Accuracy Matters

A 1-inch measurement error in chest circumference can push a customer from a Medium to a Large or Small. Across thousands of orders, even minor inaccuracies in your size guide compound into significant return rates. This guide covers how to obtain accurate measurements and present them effectively.

## Garment Measurement vs. Body Measurement

### The Critical Distinction

There are two ways to express size data, and confusing them is the single most common size guide error:

**Body measurements** describe the customer's actual body dimensions. Example: "Your chest measures 40 inches."

**Garment measurements** describe the physical dimensions of the clothing item laid flat. Example: "Chest width laid flat: 21 inches (42 inches around)."

The difference between them is called **ease** — the extra room built into the garment for comfort and movement.

### Ease by Fit Type

- Slim fit: 2-3 inches of ease in chest
- Regular fit: 3-4 inches of ease in chest
- Relaxed fit: 4-6 inches of ease in chest
- Oversized: 6+ inches of ease in chest

### Rule for Size Guides

Always label your measurements. Recommended format:
- "These are **body measurements**. Find your size by measuring yourself."
- "These are **garment measurements** (laid flat, doubled). Your body should be 2-4 inches smaller than the garment measurement."

Never present unlabeled numbers — customers will assume body measurements and end up with the wrong size.

## How to Measure a Garment (For Sellers)

### Flat-Lay Method

1. Lay the garment on a hard, flat surface (not a bed — it distorts)
2. Smooth out wrinkles without stretching
3. Button/zip the garment closed
4. Measure with a rigid ruler or retractable tape — flexible tapes can curve
5. Measure each point 3 times and take the average
6. For circumference: measure the flat width and multiply by 2

### Key Measurement Points — Tops

- **Chest/Bust width:** Measure straight across from armpit seam to armpit seam, 1 inch below the armhole
- **Waist width:** Measure at the narrowest point of the garment body (natural waist position)
- **Hem width:** Measure straight across the bottom hem
- **Body length:** Measure from the highest point of the shoulder (where shoulder seam meets neck seam) straight down to the hem
- **Sleeve length:** Measure from the shoulder seam along the top of the sleeve to the cuff
- **Shoulder width:** Measure from one shoulder seam to the other, across the back yoke

### Key Measurement Points — Bottoms

- **Waist width:** Measure straight across the top of the waistband, inside edge to inside edge
- **Hip width:** Measure at the widest point across the hip area (approximately 7-8 inches below the waist)
- **Front rise:** Measure from the top of the waistband to the crotch seam (center front)
- **Inseam:** Measure from the crotch seam straight down along the inner leg seam to the hem
- **Thigh width:** Measure across the thigh at the widest point (1 inch below crotch seam)
- **Leg opening:** Measure straight across the hem opening

### Key Measurement Points — Footwear

- **Insole length:** Remove the insole and measure from heel to toe
- **Insole width:** Measure the insole at its widest point (ball of foot area)
- **Note:** Do not measure the exterior of the shoe — it includes the sole, toe box structure, and materials that do not reflect internal fit space

## How Customers Should Measure Themselves

### General Instructions to Include

1. **Time of day:** Measure in the evening — bodies are slightly larger due to fluid distribution and activity
2. **Clothing:** Measure over the undergarments you would wear with the item (e.g., a bra for a top, thin socks for shoes)
3. **Posture:** Stand straight with arms relaxed at sides. Do not flex, suck in, or hunch
4. **Tape position:** Keep the measuring tape parallel to the floor for circumference measurements. It should be snug but not compressing the skin — you should be able to slide one finger under the tape
5. **Repeat:** Measure each point twice. If the measurements differ, use the larger one

### Measurement-Specific Instructions

**Chest/Bust:**
Stand with arms at your sides. Wrap the tape around the fullest part of your bust/chest, keeping it level with the floor. The tape should be snug but not tight — you should be able to breathe comfortably. Note: for women, wear the bra you would typically wear with this garment.

**Waist:**
Bend to one side to find your natural waistline — it is the crease that forms. Stand straight and wrap the tape around that point. Do not suck in. This is your natural waist, which may differ from where your pants sit.

**Hips:**
Stand with feet together. Wrap the tape around the fullest part of your hips and buttocks, keeping the tape level. This is typically 7-9 inches below your natural waist.

**Inseam:**
The easiest method: Measure a pair of pants that fit you well. Lay them flat, and measure from the crotch seam to the bottom of the leg along the inner seam. Alternatively: stand barefoot and have someone measure from your crotch to the floor, then subtract 1 inch for shoes.

**Foot Length:**
Place a piece of paper on a hard floor against a wall. Stand on it with your heel touching the wall. Mark the tip of your longest toe (which is not always the big toe). Measure from the edge of the paper (wall) to the mark. Do both feet — use the larger measurement.

## Presenting Measurements Effectively

### Table Design Principles

1. **Size label first:** Always put the size name/number in the first column
2. **Left to right = top to bottom of body:** Order measurements in anatomical order (shoulder → chest → waist → hip → length)
3. **Dual units side by side:** Format as "38 in / 96.5 cm" in a single cell, or use separate columns with clear headers
4. **Range format for stretch:** "36-38 in" clearly communicates the stretch range
5. **Alternating row colors:** Improve readability, especially for large tables
6. **Highlight the "between sizes" row:** If applicable, add a visual indicator

### Mobile Considerations

Large tables break on small screens. Solutions:
- Use a size-finder tool that asks for measurements and recommends a size
- Provide a "compare two sizes" view instead of the full table
- Make tables horizontally scrollable with the size column fixed
- Consider an accordion layout: tap a size to see its measurements

### Tolerance and Accuracy Disclaimers

Always include:
- "Measurements may vary by +/- 0.5 inches (1 cm) due to the nature of the product."
- "These measurements are a guide. Fabric stretch, washing, and individual body shape all affect fit."
- "When in doubt, contact us with your measurements and we will recommend a size."


path: assets/quality-checklist.md
content: # Size Guide Builder — Quality Checklist

Verify every item before delivering a size guide. Each item should be checked off.

## 1. Completeness (8 items)

- [ ] Every size offered in the product catalog has a row in the table
- [ ] All critical measurement points for the product category are included
- [ ] Dual measurement units (inches AND centimeters) are provided
- [ ] International size conversions cover all target markets
- [ ] Fit type is explicitly stated (slim, regular, relaxed, oversized)
- [ ] Fabric composition and stretch information is included
- [ ] Self-measurement instructions are provided for each measurement point
- [ ] Between-sizes guidance is included

## 2. Accuracy (7 items)

- [ ] Unit conversions are mathematically correct (1 in = 2.54 cm)
- [ ] Size progression is consistent (each size is larger than the previous in all dimensions)
- [ ] Measurements match the source data (manufacturer specs, fit samples, or user-provided data)
- [ ] Garment vs. body measurement distinction is clearly labeled
- [ ] International conversions are verified against at least 2 reference sources
- [ ] Fit notes match known customer feedback
- [ ] No copy-paste errors between sizes or measurement columns

## 3. Clarity (6 items)

- [ ] Table headers are unambiguous (no abbreviations without definition)
- [ ] Measurement points are described with anatomical landmarks, not vague terms
- [ ] Measurement instructions use action verbs and specific locations ("wrap tape around the fullest part of your bust")
- [ ] Fit descriptions are quantified where possible ("runs 0.5 size small" not just "runs small")
- [ ] Ease is explained if garment measurements are used
- [ ] Disclaimer about measurement tolerances is included

## 4. Inclusivity (5 items)

- [ ] Body-type recommendations cover at least 3 scenarios (athletic, petite, plus)
- [ ] Gender-neutral language is used where appropriate
- [ ] Extended sizes (plus, petite, tall) are included if the product offers them
- [ ] Width options are documented (for footwear: narrow, standard, wide)
- [ ] Measurement instructions work for people measuring themselves alone

## 5. Formatting (6 items)

- [ ] Tables render correctly in the target platform format (Shopify, WooCommerce, etc.)
- [ ] Tables are readable on mobile devices (scrollable or responsive)
- [ ] Size label column is first and visually distinct
- [ ] Alternating row shading or borders for readability
- [ ] Consistent number formatting throughout (decimal places, units)
- [ ] No broken characters, encoding issues, or HTML rendering problems

## 6. Actionability (5 items)

- [ ] A customer with only a measuring tape can determine their correct size
- [ ] The guide addresses the most common sizing complaints for this product category
- [ ] Contact/support path is mentioned for edge cases
- [ ] Return/exchange policy reference is included or suggested
- [ ] Guide includes a "when in doubt" recommendation (size up or size down)

## 7. Brand Consistency (4 items)

- [ ] Multi-brand stores have separate tables per brand or deviation notes
- [ ] Brand-specific fit notes are attributed to the correct brand
- [ ] Sizing data source is traceable (manufacturer spec sheet, fit sample, etc.)
- [ ] Guide matches the current season/production run, not an outdated version

## 8. SEO and Discoverability (4 items)

- [ ] Product category name appears in the guide title
- [ ] Common search terms are included naturally (e.g., "how to measure for [product]")
- [ ] Guide can be linked directly from product pages
- [ ] Alt text descriptions are provided for any visual measurement diagrams

## 9. Maintenance (5 items)

- [ ] Date of creation or last update is noted
- [ ] Process for updating the guide when new products/brands are added is defined
- [ ] Customer feedback loop is in place (sizing complaints → guide updates)
- [ ] Seasonal or limited-edition variations are flagged for separate handling
- [ ] Return data analysis cadence is recommended (quarterly minimum)

---

**Total: 50 items across 9 categories**

Score: ____/50

- 45-50: Production ready
- 38-44: Needs minor corrections
- 30-37: Significant gaps — review before publishing
- Below 30: Incomplete — revisit the workflow from Step 2


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)