Aetheria-Labs1/storefront-skills / skills/quiz
quiz
VerifiedCreate, update, validate, or preview a Lexsis Quiz island with real product recommendations, branching, variant matching, optional response saving, and consent-aware analytics.
Create a Quiz
Use the live Quiz island for the journey. Read
references/quiz-authoring.md and the current vibe://schema/island/Quiz
before authoring. Resolve unfamiliar MCP arguments through lexsis_discover.
Workflow
- Resolve the exact workspace, store, page, and theme. Load brand context and inspect available desktop/mobile references. Keep the same theme throughout.
- Refresh real candidate products and variants with
lexsis_catalog; never invent Shopify IDs, prices, availability, option values, or result imagery. - Plan stable keys, questions, branches, scoring, deterministic fallback, result explanations, product/variant mapping, and entry and exit actions. Remove questions that serve no recommendation or stated capture purpose.
- Decide whether responses should be saved. For saving, define the purpose, disclosure, question classifications, merchant visibility, retention, resume window, and optional contact purpose. Saving and analytics are independent; collecting contact details does not subscribe the visitor to marketing.
- Author one complete
Quizdefinition in normal page source. Use scoped CSS, supported hooks, and managed motion for transitions. Preserve focus and reduced-motion behavior; do not invent runtime presets or custom state machines. - Compile, repair blockers, then create or update the requested unpublished draft with version protection. Keep source and QA in MCP; do not save local JSON dumps, screenshot reports, or ad hoc page artifacts.
- If saving is requested, inspect the immutable page-version UUID using
lexsis_capture.quiz_inspectand prepare its inactive policy withlexsis_drafts.quiz_prepare. Reinspect after any source edit. - Test reachable branches/results, ties/fallbacks, required/optional inputs, back/review/restart, unavailable variants, Cart V2 outcomes, focus, transitions, and reduced motion at 390, 768, and 1280. Record supported hosted QA via MCP.
- Return
DRAFT_CREATEDwhile QA or approval is pending. RecordDESIGN_APPROVEDonly after hosted QA and explicit approval of that same version. This is a valid handoff to/publish. - When explicitly authorized, activate the reviewed policy with
lexsis_live_ops.quiz_activateand publish the reviewed page through/publish. These are separate decisions; reuse approval already given for the exact scope. Preview does not prove production capture. - After publication, verify saving allowed/declined and analytics allowed/denied, edit/reload/retry, one completed Forms response, and redacted MCP reads. Use the returned published URL. Report any untested path or live limitation.
Boundaries
- Definitions live in page source. Saved responses use the managed capture policy and Forms response viewer; do not edit generic Forms schemas to bypass it.
- Personal and sensitive answers are protected; MCP exposes only permitted
categorical values.
analytics.answerAllowlistdoes not allow raw analytics. - Result commerce uses Quiz
add_items. Do not add hidden BuyBoxes, direct Shopify requests, authored cart shells, or programmatic clicks. rewardandofferactions are unavailable. Verify existing cart promotions separately before claiming a discount or gift.- Only use registered islands and host capabilities present in the live schema. If supported hooks cannot express the design, identify the reusable host change needed; do not fabricate an island or inject arbitrary JavaScript.
- Do not promise automatic result email, marketing sync, a dedicated quiz funnel dashboard, paid-order attribution, preview capture, or historical-version resume.
Return
Report page/version and hosted URL; product sources and tested paths; responsive, cart, and motion QA; saving policy state; activation/publication state; and live capture/analytics evidence or pending checks. Keep design approval, policy activation, publication, confirmed saving, and purchase as separate outcomes.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |