design-shotgun

Generate multiple AI design variants and collect structured feedback through a comparison board.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Simon-YHKim/eject-button --skill design-shotgun-simon-yhkim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-shotgun
Source: https://github.com/Simon-YHKim/eject-button/tree/main/.claude/skills/design-shotgun
Command: npx skills add https://github.com/Simon-YHKim/eject-button --skill design-shotgun-simon-yhkim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Choosing a visual direction for a UI screen is slow when you can only imagine one option at a time. This Skill generates several distinct AI design mockups in parallel, opens them side-by-side in a browser comparison board, and captures structured ratings and comments so you can pick a direction with confidence. ## Core Features & Use Cases - Parallel Variant Generation: Launch multiple design directions at once via subagents, each with its own brief, quality check, and retry logic. - Interactive Comparison Board: Serve an HTML board over HTTP where you rate variants, leave comments, remix elements, and request regenerations. - Taste Memory: Reads previously approved designs to bias new generations toward your demonstrated aesthetic preferences. - Evolve Mode: Screenshot an existing page you dislike and generate improvement variants from it instead of starting from scratch. - Use Case: You are building a settings screen and unsure of the layout. Run the Skill, get three distinct visual directions in about a minute, compare them in your browser, and lock in an approved variant saved to your design history. ## Quick Start Ask the AI to run design-shotgun to explore visual directions for the screen you are working on.

Frequently Asked Questions about design-shotgun

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

FAQPage Schema
How do I generate multiple UI design variants at once?

Run design-shotgun with a description of the screen you want. It generates distinct concept directions, confirms them with you, then launches parallel subagents that each produce a mockup PNG with quality checks and retries.

How does the design comparison board collect feedback?

The board is served over HTTP on a local port and opened in your browser. You rate variants, leave comments, and click Submit, which writes a feedback.json file the Skill reads to determine your approved choice.

Can I improve an existing design instead of starting from scratch?

Yes. If a local site is running and you reference a page you dislike, the Skill screenshots the current page and uses the evolve command to generate improvement variants from that screenshot rather than blank-canvas concepts.

Where are generated design mockups saved?

All artifacts are saved to ~/.gstack/projects/<slug>/designs/, never to project directories like docs/ or /tmp. This keeps design history persistent across branches, conversations, and workspaces.

What happens if the design generation binary is not available?

The Skill checks for the design binary before any mockup command. If unavailable, it falls back to an HTML wireframe approach, and if the browse binary is missing it opens boards with the system default browser instead.