real-prototype

Implement design variants directly on a live app route with a switcher for in-context comparison.

3|1|Updated Aug 23, 2025
One-click install
npx skills add https://github.com/samuelpatro/.claude --skill real-prototype-samuelpatro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: real-prototype
Source: https://github.com/samuelpatro/.claude/tree/main/skills/real-prototype
Command: npx skills add https://github.com/samuelpatro/.claude --skill real-prototype-samuelpatro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Standalone mockups make every design option look fine in isolation, so teams pick layouts without seeing them against real data, headers, and page density. This Skill implements multiple structurally different design variants directly on the real route of a running app, with a live switcher to flip between them in the browser. ## Core Features & Use Cases - In-context variants: Builds 2-5 structurally different variants as separate components on the existing route, sharing the page's real data fetching, params, and auth. - Live switcher: Adds a frosted-glass floating bar driven by a ?variant= URL param, with arrow-key cycling, production gating, and collision-aware positioning. - Recommendation and cleanup: Recommends a winning variant with honest critique, then folds it into production code and deletes the losers and the switcher. - Use Case: You want to redesign a settings page. The Skill mounts three layout variants on /settings, lets you toggle them live against real account data, then rewrites the winner to production standards. ## Quick Start Ask the agent to real-prototype three variants of a specific page with a live switcher on its existing route.

Frequently Asked Questions about real-prototype

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prototype design variants on a real app page?▼

Build each variant as its own component on the existing route, keep the page's data fetching above the switch, and select the variant via a `?variant=` URL search param. Add a floating switcher bar so you can flip between variants live in the browser.

What is the difference between real-prototype and a standalone HTML prototype?▼

Real-prototype mounts variants on the live route so they are judged against real data, layout, and density. A standalone .html prototype never touches the app and is safer, but every option looks fine in isolation, which hides real design weaknesses.

How many design variants should I build for a page comparison?▼

Default to three variants, use two for a quick A/B test, and go up to four or five only when the design space is wide open. Cap at five, and make sure variants differ structurally in layout or hierarchy, not just color or copy.

Can prototype variants safely run in a production build?▼

No. The switcher and variant branching must be gated out of production builds using checks like `process.env.NODE_ENV !== 'production'`, so a stray merge can never expose prototype UI to real users.

Should prototype variants connect to real backend mutations?▼

No. Variants must stay read-only and point any write action at a stub. The goal is deciding what the page should look like, not testing whether the backend works.

What happens after a winning variant is chosen?▼

Record which variant won and why, delete the losing variants and the switcher, then rewrite the winner to production standards as you fold it into the real page. Prototype code is built read-only with minimal error handling, so it should not ship as-is.