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/lexsis-design-capabilities.md

View on GitHub
# Lexsis Page Design Capabilities

Use this contract when designing, preparing assets, generating, or
structurally optimizing a Lexsis page. `/plan-page` does not load island or
implementation guidance.

## Theme and Brand Context

Select exactly one saved store/theme pair for a page.

- Use the saved `brand-design.md` for voice, art direction, component guidance,
  and explicit design don'ts.
- Use `lexsis_brand` action `get_theme` for the current complete theme when a
  live refresh is required.
- Use `lexsis_brand` action `compile_theme` when theme CSS must be derived from
  brand inputs.
- Exact theme tokens are the normal render source. However, an explicit
  `NEVER`, `must`, or `non-negotiable` rule in the saved design guide that
  directly contradicts a matching token is invalid theme context. Return
  `THEME_CONTEXT_CONFLICT`, name both values, and stop using that property until
  the saved theme or guide is corrected. Do not silently choose one.
- Never combine design files or CSS from multiple themes on one page.

The theme compiler provides WCAG-checked `--lx-*` variables including:

- `--lx-accent-color`
- `--lx-accent-color-hover`
- `--lx-accent-soft`
- `--lx-bg-color`
- `--lx-bg-surface`
- `--lx-surface-alt`
- `--lx-text-color`
- `--lx-text-muted`
- `--lx-border-color`
- optional `--lx-font-heading`, `--lx-font-body`, and `--lx-radius`

Use tokens for brand colors, typography, surfaces, borders, and radii. Avoid
hard-coded brand values inside sections.

## Tailwind and CSS

Lexsis compiles page classes with Tailwind at compile time. There is no runtime
Tailwind CDN.

- Use Tailwind utilities for layout, spacing, sizing, and responsive behavior.
- Work mobile-first, then enhance with responsive prefixes.
- Missing Tailwind utilities are blocking compiler errors unless the class is
  explicitly defined in theme or section CSS.
- Use section CSS only for intentional, scoped components or behavior.
- Do not recreate the page layout as a second CSS system.

Compiled CSS order is:

1. theme CSS
2. generated Tailwind utilities
3. section CSS in page order

Section CSS can override earlier rules at equal specificity. Keep global
tokens and page-wide rules in theme CSS, and scope section overrides by
section ID.

The renderer supplies base styles; do not recreate its reset. Motion follows
`references/design-rules.md` N10 and `references/animation-system.md`, not
a list of renderer keyframes to reuse by default.

## Template-First Composition

Before custom composition:

0. Ask whether the user wants to pick a kit or sections themselves. If so,
   browse with `query: ""` and the page type, industry, and mood filters, and
   wait for the `Design template selection:` message. Resolve a picked or
   pasted kit with `lexsis_template_library` action `get_kit`.
1. Discover `lexsis_template_library` actions `search_page_kits`,
   `search_sections`, and `get_kit`.
2. Only when the user declines: search page kits using page type, archetype,
   objective, industry, and mood, and present at most three candidates.
3. Treat a page kit as a coherent list of section-template IDs. There is no
   single page-kit instantiation action.
4. Fetch selected section source through `lexsis_design` action `get_section`,
   at most three IDs per call.
5. Adapt the returned source to the selected theme, plan, products, copy, and
   assets.

Template search returns metadata, not editable markup. `get_section` returns
authoring source with section delimiters, `<lx-island>` markup, and section
CSS/JS.

If the host renders the Template Gallery, wait for the user's
`Design template selection:` message; without a picker, offer the public
gallery URL and accept a pasted kit or template URL. Custom composition is
allowed only after recording the evaluated templates and why none fit.

## Islands

For every interactive element:

1. Discover `lexsis_design` actions `islands` and `island_schema`.
2. Use `islands` for selection guidance.
3. Resolve the exact selected schema.
4. Confirm lifecycle status is active.
5. Use the current required props and a supported native variant.
6. Style supported `data-part` hooks listed by the schema.
7. Use headless mode only when native variants cannot satisfy the approved
   design and every required hook is implemented.

Author islands as `<lx-island>` with one readable `application/json` child.
Never hand-author compiled `data-island` or `data-props` markup.

If the catalogue marks an island deprecated or retired, follow its
replacement guidance. The replacement may be another island or supported
native HTML/CSS such as `<details>`; do not force a deprecated island into the
page.

Do not replace BuyBox or another commerce island with a custom button.

## Hosted Preview

The design-stage source is compiled and then saved as one unpublished hosted
draft. That hosted renderer is the only interactive preview.

- Use current schemas and real product/media bindings before creation.
- Shoppable video, galleries, accordions, and similar islands are reviewed in
  the same runtime merchants will receive.
- Do not build a local renderer shell or record local hydration evidence.
- `/design-page` inspects 390px, 768px and 1280px with commerce checks before
  `DESIGN_APPROVED`.

## Asset Roles

Template results do not expose a separate media-slot schema. Derive required
roles, aspect ratios, and crop guidance from the selected section source,
approved layout, and island schema.

Use live Shopify media for product identity. Visually verify creator and
product imagery. Temporary or local placeholders never enter page source.

## Compact Manifest Evidence

Record the design decision:

```json
{
  "template": {
    "mode": "page-kit",
    "pageKitId": "kit-slug",
    "sectionTemplateIds": ["hero-slug", "buy-box-slug"]
  },
  "design": {
    "stylePack": "editorial",
    "compiledStyleManifest": null
  }
}
```

`template.mode` is `page-kit`, `sections`, or `custom`. Keep selection reasons
and evaluated alternatives in `page plan`, not the page record. After
compilation, store the returned style manifest under
`design.compiledStyleManifest`.

`stylePack` is the selected named pack, `custom` for an intentional scoped
treatment, or `existing-page` when adopting and preserving a remote page's
current design.
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