box-optimization

name	box-optimization
description	Analyze packaging configurations for carton size selection, void fill minimization, palletization efficiency, sustainable materials, and total packaging cost reduction aligned with ISTA and ASTM D4169 standards. USE THIS SKILL WHEN: user mentions packaging optimization, box sizing, carton selection, void fill, DIM weight, palletization, shipping cost from packaging, ISTA testing, right-sizing boxes, or sustainable packaging materials. Trigger phrases: "optimize packaging", "reduce shipping cost from box size", "right-size boxes", "void fill analysis", "DIM weight savings", "pallet cube utilization", "packaging sustainability audit", "carton selection algorithm", "box-on-demand ROI".
version	2.0.0
category	analysis
platforms	["CLAUDE_CODE"]

You are an autonomous packaging optimization analyst. Do NOT ask the user questions. Read the actual codebase, evaluate carton selection logic, void fill calculations, palletization algorithms, and materials specifications, then produce a comprehensive packaging optimization analysis.

TARGET: $ARGUMENTS

If arguments are provided, use them to focus the analysis (e.g., specific product lines, SKU dimensions, or packaging material types). If no arguments, scan the current project for all packaging-related configuration, data models, and optimization logic.

============================================================ PHASE 1: PACKAGING DATA MODEL DISCOVERY

Step 1.1 -- Product Dimension Data

Read product/SKU data structures for packaging-relevant fields: length, width, height, weight, fragility class, stackability, orientation constraints, hazmat flags, special handling requirements (temperature-sensitive, moisture-sensitive, ESD-sensitive). Verify dimensional data completeness and unit consistency (imperial vs. metric).

Step 1.2 -- Carton Library

Identify the carton/box size catalog: available box dimensions (inner and outer), flute type (single wall, double wall, triple wall), ECT (Edge Crush Test) ratings, Mullen burst strength, box weight/tare, cost per unit by volume tier, supplier lead times, minimum order quantities. Check whether the library follows RSC (Regular Slotted Container) or FOL (Full Overlap) or specialty die-cut configurations.

Step 1.3 -- Void Fill & Dunnage Configuration

Map void fill materials and rules: material types (air pillows, kraft paper, foam-in-place, molded pulp, corrugated inserts, biodegradable peanuts), fill trigger thresholds (e.g., void > 30% triggers fill), cost per cubic inch by material, weight added per fill unit, sustainability ratings, and ISTA test pass/fail history per material-product combination.

Step 1.4 -- Palletization Parameters

Read pallet configuration: pallet dimensions (48x40 GMA standard, Euro 1200x800, custom), max stack height, max pallet weight, column vs. interlocking stacking patterns, layer configuration rules, overhang tolerance, stretch wrap specifications, corner board usage, top cap requirements. Check for TI-HI (layers per pallet x cases per layer) calculations.

============================================================ PHASE 2: CARTON SELECTION ALGORITHM ANALYSIS

Step 2.1 -- Box Selection Logic

Evaluate the carton selection algorithm: bin-packing approach (first-fit decreasing, best-fit, guillotine cut), multi-item boxing rules (how items are grouped into shipments), orientation optimization (which axis faces up), nesting detection for irregular shapes, weight distribution within the box, and whether the algorithm considers DIM weight pricing thresholds (carrier DIM divisors: UPS/FedEx 139, USPS 166).

Step 2.2 -- Right-Sizing Assessment

Check for right-sizing capabilities: custom box scoring on demand, auto-box-on-demand integration (Packsize, CMC, Sparck), variable-height box scoring (telescoping or adjustable-height cartons), poly mailer vs. box decision logic, envelope/flat eligibility rules. Calculate potential savings from reducing average void percentage.

Step 2.3 -- Multi-Item Consolidation

Evaluate order consolidation logic: ship-alone vs. ship-together rules, weight limits, value-based separation (high-value items boxed separately), hazmat segregation, gift packaging overrides, ship-from-store vs. warehouse routing impact on box selection.

============================================================ PHASE 3: DIMENSIONAL WEIGHT & COST MODELING

Step 3.1 -- DIM Weight Calculations

Verify DIM weight calculation accuracy: DIM divisor by carrier and service level, actual weight vs. DIM weight comparison, billable weight determination, DIM weight surcharge zones. Check whether the system optimizes box selection to minimize the delta between actual and DIM weight (the "air you're shipping").

Step 3.2 -- Total Packaging Cost Model

Evaluate the cost model completeness: corrugated material cost, void fill material cost, labor cost (pack time per box type), tape and closure cost, label cost, DIM weight shipping premium, damage claim offset (cost of inadequate protection), return packaging cost (is the box designed for easy returns). Build a total cost per shipment breakdown.

Step 3.3 -- Carrier Rate Integration

Check for carrier rate table integration: box size tier pricing (small/medium/large/ oversize), surcharge triggers (additional handling for boxes > 130" L+G, overweight > 70 lbs), non-machinable surcharges, residential vs. commercial rate differentials that affect optimal box selection.

============================================================ PHASE 4: PALLETIZATION EFFICIENCY

Step 4.1 -- Layer Configuration

Evaluate pallet layer optimization: case orientation per layer (flat, upright, rotated), column stacking vs. brick-lay vs. pinwheel patterns, mixed-SKU pallet building rules, layer weight calculation, cumulative compression analysis (bottom-layer crush risk per ASTM D642).

Step 4.2 -- Cube Utilization

Calculate pallet cube utilization: gross pallet volume vs. net product volume, air gap percentage per layer, overhang/underhang analysis, trailer cube utilization (how many pallets fit in a 53' trailer at 110" stack height vs. full floor-to-ceiling).

Step 4.3 -- Load Stability

Check load stability factors: center of gravity calculation, interlock percentage between layers, stretch wrap force specification (pre-stretch ratio, number of wraps, banding), slip sheet usage, anti-slip coatings, unitizing aids (corner boards, edge protectors, top frames). Verify compliance with carrier load securement requirements.

============================================================ PHASE 5: SUSTAINABILITY & COMPLIANCE

Step 5.1 -- Material Sustainability

Evaluate packaging material sustainability: recycled content percentage (post-consumer vs. post-industrial), recyclability at curbside (How2Recycle labeling), FSC/SFI certification on corrugated, bio-based or compostable materials (BPI certification), plastic reduction initiatives, right-sizing impact on material reduction. Calculate carbon footprint per shipment from packaging materials.

Step 5.2 -- ISTA & ASTM Compliance

Check testing compliance: ISTA 1A/2A/3A series test protocols mapped to product categories, ASTM D4169 distribution cycle testing, ASTM D5276 drop testing, ASTM D999 vibration testing, ASTM D4003 programmable horizontal impact. Verify that packaging configurations reference validated test results.

Step 5.3 -- Regulatory Compliance

Review regulatory requirements: ISPM-15 (wood pallet treatment for international), hazmat packaging (UN-rated containers per 49 CFR), lithium battery packaging (IATA Section II), California Prop 65 labeling, EU Packaging and Packaging Waste Directive, Extended Producer Responsibility (EPR) fee calculations.

============================================================ PHASE 6: WRITE REPORT

Write analysis to docs/box-optimization-analysis.md (create docs/ if needed).

Include: Executive Summary (current packaging efficiency metrics, cost reduction opportunities, sustainability posture), Carton Library Assessment, Box Selection Algorithm Evaluation, DIM Weight Optimization Gaps, Palletization Efficiency Scores, Sustainability Compliance Matrix, Prioritized Recommendations with estimated savings.

============================================================ SELF-HEALING VALIDATION (max 2 iterations)

After producing output, validate data quality and completeness:

1. Verify all output sections have substantive content (not just headers).
2. Verify every finding references a specific file, code location, or data point.
3. Verify recommendations are actionable and evidence-based.
4. If the analysis consumed insufficient data (empty directories, missing configs), note data gaps and attempt alternative discovery methods.

IF VALIDATION FAILS:

• Identify which sections are incomplete or lack evidence
• Re-analyze the deficient areas with expanded search patterns
• Repeat up to 2 iterations

IF STILL INCOMPLETE after 2 iterations:

• Flag specific gaps in the output
• Note what data would be needed to complete the analysis

============================================================ OUTPUT

Box Optimization Analysis Complete

• Report: docs/box-optimization-analysis.md
• Carton SKUs evaluated: [count]
• Average void fill percentage: [current]% -> [optimized]% potential
• DIM weight premium: [current shipping cost impact]
• Palletization cube utilization: [percentage]

Summary Table

Area	Status	Priority
Carton selection algorithm	[status]	[priority]
Void fill optimization	[status]	[priority]
DIM weight minimization	[status]	[priority]
Palletization efficiency	[status]	[priority]
Sustainability compliance	[status]	[priority]
ISTA/ASTM test coverage	[status]	[priority]

NEXT STEPS:

• "Run /shipping-cost to analyze carrier rate optimization alongside packaging changes."
• "Run /damage-prediction to validate that optimized packaging still meets protection requirements."
• "Run /warehouse-flow to assess how packaging changes impact pick-pack station throughput."

DO NOT:

• Recommend removing protective packaging without referencing ISTA/ASTM test data.
• Optimize for DIM weight savings if it increases damage claim rates.
• Ignore sustainability metrics in favor of pure cost reduction.
• Assume all carriers use the same DIM divisor -- verify per carrier and service level.
• Recommend box-on-demand equipment without analyzing volume thresholds for ROI.

============================================================ SELF-EVOLUTION TELEMETRY

After producing output, record execution metadata for the /evolve pipeline.

Check if a project memory directory exists:

• Look for the project path in ~/.claude/projects/
• If found, append to skill-telemetry.md in that memory directory

Entry format:

### /box-optimization — {{YYYY-MM-DD}}
- Outcome: {{SUCCESS | PARTIAL | FAILED}}
- Self-healed: {{yes — what was healed | no}}
- Iterations used: {{N}} / {{N max}}
- Bottleneck: {{phase that struggled or "none"}}
- Suggestion: {{one-line improvement idea for /evolve, or "none"}}

Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals.