prototype

Build throwaway HTML demos and UI variants to answer design questions.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill prototype-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prototype
Source: https://github.com/gmackie/agent-skills/tree/main/skills/prototype
Command: npx skills add https://github.com/gmackie/agent-skills --skill prototype-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design questions about state models, business logic, or UI layout are hard to settle on paper. This Skill produces throwaway prototypes that let you and stakeholders press buttons, flip between variants, and feel whether a model or design actually works before committing to real code. ## Core Features & Use Cases - Logic Prototypes: Generate a single self-contained HTML file with free-play action buttons and tabbed guided walkthroughs that push a state machine or reducer through edge cases, usable by non-developers. - UI Prototypes: Generate 3-5 radically different UI variants on one route, switchable via a ?variant= URL param and a floating bottom bar with arrow-key cycling. - Capture Workflow: Fold validated decisions into real code while committing the prototype itself to a throwaway branch as a primary source. - Use Case: A PM is unsure whether a checkout state machine handles the "cancel after payment" edge case. Use this Skill to build a shareable HTML demo they can click through to find the bugs in the idea. ## Quick Start Ask the agent to prototype whether your state model handles a specific edge case, or to generate three UI variants of an existing page switchable via a URL parameter.

Frequently Asked Questions about prototype

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

FAQPage Schema
How do I prototype a state machine before writing production code?▼

Build a single self-contained HTML file with a pure reducer or state machine module, free-play action buttons, and tabbed guided walkthroughs for edge cases. The file opens by double-click with no framework, bundler, or server required.

How to generate multiple UI design variants on one page?▼

Render 3-5 structurally different variants on the same route gated by a ?variant= URL search param, with a floating bottom bar for cycling. Keep existing data fetching intact and only swap the rendered subtree per variant.

Should a prototype use a framework like React or plain HTML?▼

Logic prototypes should be one plain HTML/CSS/JS file with everything inline so non-developers can open and share them. UI prototypes follow the host project's existing framework and component library since they live on real routes.

When should I not use a throwaway prototype?▼

Skip prototyping when the question is already answered or when the code needs tests, error handling, and persistence from the start. Prototype code is written under throwaway constraints and must be rewritten properly when folded into production.

What happens to prototype code after the question is answered?▼

The validated decision gets folded into the real code, while the prototype itself is committed to a throwaway branch as a primary source. A context pointer to that branch is left on the implementation issue, keeping main clean.