Skip to content

Aetheria-Labs1/storefront-skills / skills/publish

publish

Verified

Publish a Lexsis storefront draft version that carries DESIGN_APPROVED from /design-page, /quiz, or /optimize. Use only when the user explicitly asks to release a specific page version.

FileKindSize
SKILL.mdskill md3.5 KB
agents/openai.yamlconfig404 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/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/generate-collection.mdmarkdown555 B
references/generation-protocol.mdmarkdown3.2 KB
references/islands/collection-grid/index.mdmarkdown5.4 KB
references/islands/collection-swipe/index.mdmarkdown4.1 KB
references/lexsis-mcp-contract.mdmarkdown14.2 KB
references/merchant-templates.mdmarkdown2.6 KB
references/module-authoring.mdmarkdown9.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-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/collection-landing.mdmarkdown21.9 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/assets/asset-sourcing-sequence.md

View on GitHub
# Asset sourcing sequence

The ordered algorithm `/plan-assets` runs for every asset slot, the checks at
each step, how the result is recorded, the grouped asset question, and what
happens when the merchant postpones a slot. Tool mechanics (arguments,
picker behaviour, import flow) are in `references/asset-prep.md` and
`references/design-assets.md`; this file is the policy above them. Jobs come
from `references/assets/image-jobs-by-page-type.md`, technical thresholds from
`references/assets/slot-spec.md`, generation limits from
`references/assets/generation-policy.md`.

Tags: LAW, RESEARCH, OPERATOR, HEURISTIC as defined in
`image-jobs-by-page-type.md`.

## 1. The algorithm

Run per slot. Stop at the first step that yields an asset passing every
check in section 3. Record the step name in the plan's Source decision column.

```text
for slot in plan.asset_slots:
  if slot.status == verified and slot picked by the user: keep; next slot
  1. SHOPIFY PRODUCT MEDIA      lexsis_catalog.get (product and variant media)
  2. STORE ASSET LIBRARY        lexsis_asset_library.search (mode: tags, then semantic)
  3. MERCHANT-SUPPLIED MEDIA    lexsis_asset_import.import (URLs, base64, attachments) or lexsis_asset_upload.upload (local-file UI)
  4. SUPPLIER OR MANUFACTURER   lexsis_asset_import.import after a written licence check
  5. LICENSED STOCK             backdrop, context or raw-material roles only; import
  6. GENERATION                 references/assets/generation-policy.md (ALLOW auto after credit confirmation; ASK after merchant yes; NEVER blocked)
  else: slot remains unresolved; no placeholder
```

Steps 3 to 6 run only for the jobs their row in section 7 of
`image-jobs-by-page-type.md` allows. An identity-bound job (product, variant,
included items, label, packaging, founder, UGC, result) ends at step 4.
Search is read-only and does not pause the workflow. After candidates pass the
fit review, call `lexsis_asset_select.select` only when the user should make
the final choice; wait only for that selection call.

## 2. Step details

| Step | Call | What qualifies | Step-specific checks | Rights basis | Source decision string | Manifest `sourceType` |
|---|---|---|---|---|---|---|
| 1 Shopify media | `lexsis_catalog.get` with the product id; read `media` (images and video, up to 250 per product https://help.shopify.com/en/manual/products/product-media/add-media ) and variant-to-media mapping | The exact SKU and variant the slot needs | Variant image exists for every `variation` slot; first media item is the identity packshot; no stale sold-out variant art | Merchant's catalog; no record needed | `shopify media` | `shopify` with `productId` and `mediaId` |
| 2 Asset library | `lexsis_asset_library.search` with `theme_id` (required), `kind: image` or `svg` or `video`, `mode: "tags"` using `product-shot`, `hero`, `lifestyle`, `flat-lay`, `social-proof`, `logo`, `banner`, `before-after`; then a semantic `query` | Approved brand assets, prior imports, UGC with a rights record | Licence scope covers "website or landing page"; UGC has a proof-ledger row; consent for people depicted; not expired; purpose tag matches the job | Existing library record | `library <asset id>` | `lexsis` with `assetId` |
| 3 Merchant-supplied | `lexsis_asset_import.import` with exactly one source: `url`, image `data` + `mime_type`, or `attachments`; `lexsis_asset_upload.upload` exclusively opens the local-file UI, then wait for the user's uploaded-asset message | Files the merchant sends; originals from the merchant's own site, Instagram or TikTok accounts pulled with the merchant's authorisation for this store | Original file, not a screenshot; if the post shows a creator or customer, treat as UGC and require their permission; music or third-party IP cleared for video | Merchant states ownership; record "merchant owns, <date>" | `merchant-upload (owner: merchant, <date>)` | `lexsis` after import |
| 4 Supplier | `lexsis_asset_import.import` with tag `supplier` | Manufacturer or distributor imagery of the exact SKU | Written licence for retail marketing use; not a sibling model; watermark removal only if the licence permits; resolution per slot | Supplier licence; record reference | `supplier (licence: <ref>)` | `lexsis` after import |
| 5 Licensed stock | External search (Unsplash, Pexels or a paid library per `references/asset-prep.md`), then `lexsis_asset_import.import` with tag `stock` | Backdrops, occasion scenes without the product, raw ingredient or material flat lays, scenes with people who are clearly not presented as customers | Licence covers commercial web use and the store's territories; no editorial-only licence; model release when a face is visible; no recognisable brands, logos or signage | Stock licence id | `stock (licence: <id>)` | `lexsis` after import |
| 6 Generation | `lexsis_workspace.credits`, then `lexsis_drafts.asset_generate` | ALLOW purposes; ASK purposes with a logged merchant yes | Section 8 checklist in `generation-policy.md`; provenance recorded | Merchant's credit confirmation and, for ASK, written yes | `generated (<purpose>, library: none)` | `lexsis` with `generated: true`, `provider` |

Never scrape third-party posts, competitor sites or marketplaces for images.
Never hotlink; every external file is imported before use so it lives in the
brand library and survives the source going away.

## 3. Acceptance

`references/workflows/section-asset-workflow.md` section 2 owns visual fit
and set review. `references/assets/slot-spec.md` owns dimensions, crop,
focal point and color-profile requirements. Check source rights through
section 2 of this file before accepting a slot. The original research
sources remain under Rules and Sources below.

## 4. Recording the result

Asset handoff (`## Asset bindings`). Put the job and rights basis in the
binding and production records:

```markdown
| Slot | Section | Role/purpose | Aspect | Source decision | Id / URL | Status |
|---|---|---|---|---|---|---|
| A1 | gallery | product_media (identity) | 1:1 | shopify media, viewed | gid://shopify/MediaImage/123 | verified |
| A2 | gallery | product_media (scale) | 4:5 | merchant-upload (owner: merchant, 2026-09-10), viewed | asset 8c1f... | verified |
| A3 | hero | hero_bg | 16:9 + 4:5 | generated (hero_bg, library: none), credits confirmed | asset 2d9a... | verified |
| A4 | ugc-grid | proof (ugc, ledger P5) | 1:1 | library, rights record P5 | asset 71bb... | verified |
| A5 | benefits | product_media (in-use) | 3:2 | pending: no in-use media; NEVER for generation | | planned |
```

Merchant uploads, supplier files, stock and external outputs receive a
permanent Lexsis id after import. The origin, licence, consent and operation
history remain in the asset production record.

## 5. Acquisition and unresolved slots

Execute `references/workflows/section-asset-workflow.md` sections 1 and 2.
That owner defines the grouped merchant question, UI/import split, missing
slot handling and view-and-fit review. This file defines source eligibility,
not a second fallback procedure or draft/production state table.

## 7. Rules

Checks use persisted MCP source and the hosted draft.

AS1. Execute the acquisition procedure in `references/workflows/section-asset-workflow.md` section 1; use this file to decide source eligibility. OPERATOR.

AS2. Search Shopify media and the library before any generation call. OPERATOR.
Rationale: generation is the last step and spends credits; duplicates of existing brand media are waste.
Check: every `generated` Source decision carries `library: none`; no `lexsis_drafts.asset_generate` call precedes the slot's `lexsis_asset_library.search` in the session.

AS3. Verify identity through the shared fit procedure in `references/workflows/section-asset-workflow.md` section 2. OPERATOR.

AS4. Never source the product, customers, founders, staff, before/after pairs or press from stock. LAW, RESEARCH.
Rationale: fake testimonials and endorsements are banned under 16 CFR 465 https://www.ftc.gov/business-guidance/resources/consumer-reviews-testimonials-rule-questions-answers ; stock people are ignored and read as filler https://www.nngroup.com/articles/photos-as-web-content/ .

AS5. Import every external file before use; no hotlinks, no local files, no placeholders. OPERATOR.
Rationale: assets must survive the source disappearing and be reusable from the library (`references/asset-prep.md`).

AS6. Record the rights basis for every slot in the Source decision. LAW.
Rationale: UGC needs recorded, scoped permission; a tag or hashtag is not a licence https://later.com/blog/user-generated-content-rules/ ; stock needs a commercial licence for the territories.
Check: no slot row has an empty Source decision; every `proof (ugc...)` row cites a proof-ledger id (`P[0-9]+`).

AS7. Reject near-duplicates within one gallery or grid. RESEARCH.
Rationale: every gallery position must add information; truncated or repeated images waste the positions shoppers do see https://baymard.com/blog/truncating-product-gallery-thumbnails .
Check: view all slots of one section together; near-identical pairs count is 0 (yes/no in `QA record`).

AS8. Use the grouped unresolved-slot handling in `references/workflows/section-asset-workflow.md` section 1. OPERATOR.

AS9. Follow the shared asset workflow for postponed slots; never mark
`ASSETS_READY` with a placeholder. OPERATOR.

AS10. Accept an asset only after the slot-spec resolution and aspect checks; art-direct the mobile hero instead of scaling the desktop crop. RESEARCH.
Rationale: scaled-down landscape heroes shrink the product and push the CTA below the fold https://www.nngroup.com/articles/big-pictures-small-screens/ ; https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images .
Check: import response `width`/`height` meets `slot-spec.md`; the hero `<picture>` has a `<source media="(max-width: 767px)">` whose dimensions are portrait.

AS11. Reject any candidate with a watermark, supplier logo, price sticker, border or baked-in copy. LAW.
Rationale: Google disapproves promotional overlays https://support.google.com/merchants/answer/6101131 ; WCAG 1.4.5 images of text https://www.w3.org/WAI/tutorials/images/ .
Check: view each candidate; on-pack text only (yes/no).

AS12. Check `lexsis_workspace.credits` and obtain the merchant's confirmation before any paid call. OPERATOR.
Rationale: `/design-page` authorises one page-creation credit, not asset generation.
Check: the session shows `lexsis_workspace.credits` before the first `lexsis_drafts.asset_generate`, and the merchant's reply contains a yes to the named batch.

AS13. Treat brand-owned social posts that show a creator or customer as UGC, not as brand lifestyle. LAW.
Rationale: copyright sits with the creator; consent of people depicted is separate https://thesocialmedialawfirm.com/blog/social-media-compliance/ugc-legal-risks-and-compliance-a-2026-guide/ .
Check: any `merchant-upload` slot whose alt names a person or handle also cites a ledger `P` id.

## Sources

- Shopify media limits https://help.shopify.com/en/manual/products/product-media/add-media ; media types https://help.shopify.com/en/manual/products/product-media/product-media-types
- Google Merchant image requirements https://support.google.com/merchants/answer/6324350 ; promotional overlay https://support.google.com/merchants/answer/6101131 ; product data spec https://support.google.com/merchants/answer/7052112
- Shopify Theme Store requirements https://shopify.dev/docs/storefronts/themes/store/requirements
- W3C images tutorial https://www.w3.org/WAI/tutorials/images/ ; alt decision tree https://www.w3.org/WAI/tutorials/images/decision-tree/
- MDN responsive images https://developer.mozilla.org/en-US/docs/Web/HTML/Guides/Responsive_images
- NN/g photos as web content https://www.nngroup.com/articles/photos-as-web-content/ ; big pictures small screens https://www.nngroup.com/articles/big-pictures-small-screens/
- Baymard truncated thumbnails https://baymard.com/blog/truncating-product-gallery-thumbnails
- FTC consumer reviews rule Q&A https://www.ftc.gov/business-guidance/resources/consumer-reviews-testimonials-rule-questions-answers
- UGC rights: Later https://later.com/blog/user-generated-content-rules/ ; Social Media Law Firm https://thesocialmedialawfirm.com/blog/social-media-compliance/ugc-legal-risks-and-compliance-a-2026-guide/
- Amazon image resolution guidance https://sellercentral.amazon.com/help/hub/reference/external/G1881
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall