Skip to content

Aetheria-Labs1/storefront-skills / skills/optimize

optimize

Flagged

Score an existing Lexsis page against the same page-type, design, proof, offer, asset and copy rules used to build pages, propose improvements as a strict optimization plan with real replacement copy and asset decisions, wait for approval, then apply the approved changes with version protection and hosted QA.

FileKindSize
SKILL.mdskill md13.6 KB
agents/openai.yamlconfig499 B
references/ab-testing.mdmarkdown6.3 KB
references/ad-to-page.mdmarkdown1.3 KB
references/animation-system.mdmarkdown11.1 KB
references/anti-patterns/copy-anti-patterns.mdmarkdown12.2 KB
references/anti-patterns/cro-anti-patterns.mdmarkdown17.8 KB
references/anti-patterns/dark-patterns.mdmarkdown23.9 KB
references/anti-patterns/design-anti-patterns.mdmarkdown9.3 KB
references/anti-patterns/mobile-anti-patterns.mdmarkdown9.7 KB
references/asset-prep.mdmarkdown6.9 KB
references/assets/asset-sourcing-sequence.mdmarkdown12.2 KB
references/assets/generation-policy.mdmarkdown25.9 KB
references/assets/image-jobs-by-page-type.mdmarkdown31.8 KB
references/assets/imagery-by-vertical.mdmarkdown24.8 KB
references/assets/slot-spec.mdmarkdown20.2 KB
references/assets/video-rules.mdmarkdown17.6 KB
references/authoring/css-and-styling.mdmarkdown4.0 KB
references/authoring/source-authoring.mdmarkdown9.0 KB
references/blob-shapes.mdmarkdown1018 B
references/cart-composition.mdmarkdown7.2 KB
references/cart-profile-management.mdmarkdown17.1 KB
references/consumer-behavior-cro.mdmarkdown12.7 KB
references/conversion-psychology.mdmarkdown403 B
references/copy/copy-frameworks.mdmarkdown20.5 KB
references/copy/headline-and-cta-rules.mdmarkdown12.9 KB
references/copy/message-match.mdmarkdown9.2 KB
references/copy/voice-of-customer-mining.mdmarkdown10.9 KB
references/design-assets.mdmarkdown366 B
references/design-enrichment.mdmarkdown334 B
references/design-rules.mdmarkdown15.5 KB
references/evidence-led-cro.mdmarkdown1.2 KB
references/generate-bundle-page.mdmarkdown303 B
references/generate-collection.mdmarkdown555 B
references/generate-editorial.mdmarkdown366 B
references/generate-homepage.mdmarkdown280 B
references/generate-landing-page.mdmarkdown335 B
references/generate-listicle.mdmarkdown295 B
references/generate-pdp.mdmarkdown312 B
references/generation-protocol.mdmarkdown3.2 KB
references/industry-cro.mdmarkdown433 B
references/island-patterns.mdmarkdown380 B
references/islands/collection-grid/index.mdmarkdown5.4 KB
references/islands/collection-swipe/index.mdmarkdown4.1 KB
references/lexsis-design-capabilities.mdmarkdown6.2 KB
references/lexsis-mcp-contract.mdmarkdown14.2 KB
references/merchant-templates.mdmarkdown2.6 KB
references/module-authoring.mdmarkdown9.0 KB
references/offers/aov-levers.mdmarkdown17.0 KB
references/offers/campaign-calendar.mdmarkdown21.4 KB
references/offers/funnel-stages.mdmarkdown17.6 KB
references/offers/offer-ledger.mdmarkdown5.1 KB
references/offers/offer-stacking.mdmarkdown3.5 KB
references/offers/offer-strategy.mdmarkdown9.6 KB
references/offers/offer-types.mdmarkdown36.6 KB
references/offers/price-presentation.mdmarkdown18.0 KB
references/offers/urgency-scarcity.mdmarkdown17.5 KB
references/page-editing.mdmarkdown9.7 KB
references/page-files.mdmarkdown2.7 KB
references/page-types/_checklist-format.mdmarkdown11.1 KB
references/page-types/_index.mdmarkdown21.9 KB
references/page-types/ad-landing-page.mdmarkdown29.0 KB
references/page-types/advertorial.mdmarkdown28.2 KB
references/page-types/brand-story-founder.mdmarkdown20.6 KB
references/page-types/bundle-kit.mdmarkdown27.4 KB
references/page-types/collection-landing.mdmarkdown21.9 KB
references/page-types/comparison-us-vs-them.mdmarkdown24.5 KB
references/page-types/faq-support-led.mdmarkdown20.4 KB
references/page-types/gift-guide.mdmarkdown22.0 KB
references/page-types/homepage.mdmarkdown23.6 KB
references/page-types/ingredient-science.mdmarkdown28.3 KB
references/page-types/launch-waitlist-preorder.mdmarkdown28.1 KB
references/page-types/lead-capture-giveaway.mdmarkdown22.6 KB
references/page-types/listicle.mdmarkdown27.2 KB
references/page-types/lookbook-shop-the-look.mdmarkdown19.6 KB
references/page-types/offer-page.mdmarkdown25.8 KB
references/page-types/pdp-hybrid-landing.mdmarkdown31.1 KB
references/page-types/pdp.mdmarkdown32.8 KB
references/page-types/quiz-funnel.mdmarkdown26.2 KB
references/page-types/referral-loyalty-vip.mdmarkdown18.4 KB
references/page-types/restock.mdmarkdown23.3 KB
references/page-types/retargeting-warm.mdmarkdown24.9 KB
references/page-types/sale-clearance-flash.mdmarkdown25.0 KB
references/page-types/seasonal-gifting.mdmarkdown26.9 KB
references/page-types/seo-buyers-guide.mdmarkdown23.9 KB
references/page-types/subscription.mdmarkdown26.5 KB
references/page-types/thank-you-post-purchase.mdmarkdown19.7 KB
references/page-types/trial-sample.mdmarkdown24.4 KB
references/page-types/ugc-creator-collab.mdmarkdown27.5 KB
references/page-types/video-sales-page.mdmarkdown25.1 KB
references/page-types/wholesale-b2b.mdmarkdown24.2 KB
references/plan-page.mdmarkdown9.7 KB
references/product-grid.mdmarkdown2.0 KB
references/proof/before-after-and-claims.mdmarkdown19.2 KB
references/proof/numbers-and-counts.mdmarkdown16.0 KB
references/proof/press-and-media-mentions.mdmarkdown12.5 KB
references/proof/proof-ledger.mdmarkdown8.3 KB
references/proof/reviews-sourcing.mdmarkdown24.8 KB
references/proof/trust-badges-certifications.mdmarkdown21.8 KB
references/proof/ugc-rights-and-display.mdmarkdown16.0 KB
references/publishing.mdmarkdown2.4 KB
references/qa-recipe.mdmarkdown4.3 KB
references/quiz-authoring.mdmarkdown14.5 KB
references/resource-templates.mdmarkdown7.7 KB
references/scroll-patterns.mdmarkdown1.2 KB
references/source-artifact-workflow.mdmarkdown3.7 KB
references/styling-hooks.mdmarkdown7.8 KB
references/traffic-source-google.mdmarkdown1.6 KB
references/traffic-source-meta.mdmarkdown1.5 KB
references/traffic-source-tiktok.mdmarkdown1.5 KB
references/vertical-beauty.mdmarkdown1.8 KB
references/vertical-fashion.mdmarkdown1.7 KB
references/vertical-food.mdmarkdown1.6 KB
references/vertical-home.mdmarkdown1.7 KB
references/vertical-luxury.mdmarkdown1.6 KB
references/vertical-supplements.mdmarkdown1.7 KB
references/workflow-intent.mdmarkdown2.0 KB
references/workflows/_how-to-read.mdmarkdown2.7 KB
references/workflows/copy-workflow.mdmarkdown1.5 KB
references/workflows/island-selection-workflow.mdmarkdown4.8 KB
references/workflows/section-asset-workflow.mdmarkdown5.8 KB

references/consumer-behavior-cro.md

View on GitHub
# Consumer Behavior and CRO Decision Framework

Use this reference to turn shopper behavior into page decisions. It is a
hypothesis library, not a checklist. A page should usually activate two or
three relevant patterns, not every pattern below.

## Decision Protocol

Before asking the merchant or choosing a module:

1. Read the product, variants, price, inventory, existing media, reviews,
   policies, audience, traffic source, and available analytics.
2. Classify the visitor's likely primary mode:
   - **confirm**  -  knows the product and wants confidence to buy;
   - **compare**  -  deciding between options or alternatives;
   - **explore**  -  needs inspiration or use-case education;
   - **complete**  -  wants the full solution, routine, or setup;
   - **replenish**  -  returning for a refill, replacement, or repeat order.
3. Write the three most important questions the shopper must answer before
   buying.
4. Select at most three behavioral patterns that answer those questions.
5. Map each selected pattern to evidence, one page response, any required
   asset, and one primary metric.

Do not add a carousel, bundle, urgency treatment, sticky CTA, quiz, or proof
module merely because the pattern exists. Every module must reduce a named
uncertainty or decision cost.

## Merchant Questions

Inspect available evidence first. Ask only when the answer changes the page,
requires unavailable business knowledge, or spends credits. Group no more than
three questions in one turn.

Useful conditional questions include:

- **Gallery gap:** "The current media shows the pack and texture, but not scale
  or in-use context. Can you supply the real scale and
  in-use photos, or should those jobs remain pending?"
- **Relationship:** "Should the recommendation help shoppers complete the
  routine, compare alternatives, replenish later, or should this page avoid
  recommendations?"
- **Compatibility:** "Do you have a verified model, size, shade, ingredient,
  room-dimension, or usage mapping for these add-ons?"
- **Risk:** "Which verified shipping, returns, trial, warranty, cancellation,
  or guarantee terms can appear beside the purchase decision?"
- **Audience state:** "Is this primarily a first purchase, an experienced
  buyer, or a returning/replenishment visit?"
- **Traffic context:** "Which promise or creative brought this traffic here,
  if the page must preserve message match?"

Never ask "Do you want custom images?" without first identifying the missing
decision job, proposed image count, purpose, and likely placement. Paid image
generation remains separately credit-gated.

## Behavioral Pattern Library

| Pattern | Shopper signal or uncertainty | Page response | Primary measurement |
|---|---|---|---|
| Scan-first decision packet | High-intent visitor wants to verify and act quickly | Make product identity, promise, price, variants, availability, delivery/returns cue, proof summary, and primary CTA scannable in the first decision area | Add-to-cart rate, time to CTA |
| Visual investigation | Product appearance materially affects choice | Give the gallery clear next-image cues and cover product, detail, in-use, scale, variation, included items, and result/proof jobs where relevant | Gallery engagement, conversion |
| Scale, fit, and sensory confidence | Size, fit, texture, finish, shade, or quantity is hard to judge | Add dimension diagrams, familiar-object scale, model measurements, texture close-ups, swatches, or use-context imagery | Returns, fit questions, conversion |
| Information scent | Shoppers need detail but will not parse a wall of copy | Lead with benefit and decision fact, then expose specifications, ingredients, care, or methodology through clear progressive disclosure | Detail interaction, conversion |
| Choice reduction | Too many variants, bundles, or recommendations compete | Prioritize the likely default, explain differences, and keep the first recommendation set to two or three choices | Variant completion, conversion |
| Guided comparison | Visitor is deciding between products or tiers | Compare only decision-driving attributes; state "best for" and meaningful trade-offs without manufacturing a winner | Comparison interaction, product selection |
| Compatibility confidence | Add-on usefulness depends on model, shade, size, ingredient, room, or regimen fit | Show the verified fit reason beside each recommendation and suppress incompatible or unavailable items | Attach rate, support questions, returns |
| Solution completeness | The hero SKU is only one part of the shopper's job | Present the minimum complete outfit, routine, stack, recipe, room, setup, care kit, or commissioning kit with individually selectable items | Attach rate, AOV, revenue per visitor |
| Sequence and next step | Products are understood as stages or order of use | Show when, how, and in what order products are used; distinguish morning/evening, setup/use/care, or beginner/advanced | Bundle attach rate, education engagement |
| Context and mental simulation | Shopper cannot picture ownership or final use | Show the product in the actual scene, occasion, room, routine, task, or before/after context using truthful media | Context-image engagement, conversion |
| Replenishment and continuity | Consumable, maintenance item, size progression, or replacement cycle exists | Explain serving/use count, refill timing, cadence, compatible replacement, or easy reorder without inventing depletion dates | Repeat purchase, subscription opt-in |
| Returning-customer shortcut | Existing buyers need less education and more continuity | Prefer refill, reorder, saved configuration, compatible replacement, or "what changed" paths when reliable customer context exists | Repeat conversion, time to purchase |
| Proof proximity | A claim creates doubt at a specific decision point | Place sourced review excerpts, customer media, certification, test evidence, or expert proof beside the claim it supports | Proof interaction, conversion |
| Risk reversal | Delivery, fit, efficacy expectations, warranty, returns, or subscription cancellation creates hesitation | Put verified policy and guarantee language beside the relevant CTA or choice; make conditions legible | Checkout progression, support contacts |
| Price comprehension | Shopper cannot understand total value or recurring cost | Show current price, factual compare-at price, unit/cost-per-use where accurate, bundle contents, cadence, and savings calculation without deceptive anchoring | Conversion, AOV, margin |
| Effort reduction | Selecting an add-on or completing the setup requires navigation and rework | Allow inline selection, preserve the primary product choice, and avoid forcing page exits for two or three simple additions | Attach rate, abandonment |
| Commitment and ownership | Configuration increases relevance but can also create work | Use short builders, quizzes, or progress only when answers materially change the recommendation; show editable selections and a clear result | Builder completion, conversion |
| Mobile context preservation | Long scrolling hides product identity and purchase state | Keep gallery cues visible, repeat concise product context at major decision points, use short sections, and use a non-obstructive sticky CTA only when helpful | Mobile conversion, CTA usage |
| Message match | Visitor arrives from a specific ad, search, creator, or campaign promise | Repeat the same product, outcome, offer, and visual context early; do not make cold traffic reconstruct the premise | Bounce, conversion by source |
| Ethical urgency | Real stock, cutoff, launch, or event timing matters | Show only verified availability or deadlines, explain the consequence plainly, and remove stale urgency automatically | Conversion, cancellations, trust |
| Post-purchase clarity | Shopper worries about what happens after payment | Explain delivery, setup, first use, support, returns, warranty, subscription management, or expected next step | Checkout completion, support questions |
| Cognitive and performance ease | Heavy media or many modules slow comprehension or rendering | Keep one primary action per decision area, remove duplicate modules, optimize media, and preserve fast visual stability | Core Web Vitals, bounce, conversion |

## Relationship-Based Merchandising

Name the customer's job instead of using a generic "Recommended for You."
Start with two or three relevant products and show why each belongs.

| Vertical | Useful relationship names and jobs |
|---|---|
| Fashion | Complete the Look, Shop the Occasion, Three Ways to Wear It, Fit Kit, Care for This |
| Beauty | Complete Your Routine, Morning vs Evening, Solve the Concern, Shade Companion, Starter vs Refill |
| Supplements | Build Your Stack, Goal Protocol, Time-of-Day Stack, 30-Day Start, Refill the Stack |
| Food | Pair It With, Shop the Recipe, Make It a Meal, Flavor Flight, Occasion Box |
| Home | Complete the Room, Shop the Scene, Finish the Surface, Install and Protect, Match the Finish |
| Electronics | Make It Work, Compatibility Check, Protect It, Creator Kit, Replace the Consumable |
| Pet | Complete Their Care Routine, Life-Stage Bundle, Enrichment Set, Refill Reminder |
| Baby | Set Up the Station, Feeding Stage Kit, Size-Up Reminder, Daycare Pack |
| Travel | Complete the Packing System, Trip Type Kit, Destination Weather Kit, Carry-On Kit |
| B2B | Commissioning Kit, Compatible Parts, Maintenance Kit, Reorder This Set, Job-Specific Kit |

The relationship may be complementary, compatible, sequential, protective,
replenishing, substitutive, occasion-based, or an upgrade. Record which one it
is. Do not infer medical compatibility, technical compatibility, shade match,
or safety from visual similarity.

## Gallery Job Coverage

Treat the gallery as decision support. Check only jobs relevant to the product:

- identity and every included item;
- multiple angles and important detail;
- scale, dimensions, fit, or model reference;
- texture, material, finish, shade, or consistency;
- in-use context and the intended environment;
- variation across color, size, flavor, or configuration;
- installation, sequence, routine, or setup;
- sourced result, proof, or customer media.

Use `references/workflows/section-asset-workflow.md` for unresolved gallery
jobs and inspection. That procedure applies the source/generation policies;
a behavioral hypothesis does not authorize synthetic product or result media.

## Plan Handoff

Add this compact block to `page plan`:

```markdown
## Consumer decision model

**Primary visitor mode.** confirm | compare | explore | complete | replenish
**Top decision questions.** Three shopper questions this page must answer.
**Selected behavioral patterns.** At most three, each with observed evidence.
**First decision area.** Facts, proof, and action visible before deeper detail.
**Gallery jobs.** covered; missing; asset slots created for missing jobs.
**Guided merchandising.** relationship name, reason, 2-3 products or none.
**Risk and trust.** sourced proof/policy placed beside the relevant decision.
**Mobile context.** what remains visible or is repeated during long scroll.
**Hypothesis and metric.** one primary behavior change and measurement.
```

`/design-page` implements this block without reopening settled choices.
`/optimize` and `/ab-test` use it to form one controlled, measurable
hypothesis.

## Guardrails

- Treat every pattern as a testable hypothesis, not a guaranteed lift.
- Protect primary-product conversion when introducing cross-sells.
- Measure attach rate, AOV or revenue per visitor, conversion, margin,
  returns/refunds, and support questions as appropriate.
- Segment meaningful results by device, traffic source, new/returning status,
  and product family when data supports it.
- Never fabricate reviews, customer counts, scarcity, compatibility, savings,
  clinical outcomes, delivery promises, or personalization.
- Avoid dark patterns: preselected paid add-ons, hidden recurring terms,
  obstructive sticky controls, fake countdowns, confirmshaming, or difficult
  opt-out.

## Evidence Foundation

This framework synthesizes merchant-provided Shopify CRO research with:

- Baymard product-page, image-gallery, description, cross-sell, and mobile UX
  research: `https://baymard.com/research/product-page`
- Shopify related and complementary recommendation guidance:
  `https://shopify.dev/docs/apps/build/product-merchandising/recommendations`
- Shopify Search & Discovery recommendation guidance:
  `https://help.shopify.com/en/manual/online-store/search-and-discovery/product-recommendations`
- Nielsen Norman Group progressive-disclosure guidance:
  `https://www.nngroup.com/articles/progressive-disclosure/`
- UK Competition and Markets Authority guidance on urgency and price-reduction
  claims: `https://www.gov.uk/government/publications/online-choice-architecture-how-digital-design-can-harm-competition-and-consumers`
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall