Generate variants for Stitch screens: $ARGUMENTS
$ARGUMENTS should include:
- What to explore (e.g., "try different layouts for the dashboard", "explore color alternatives for the landing page", "reimagine the onboarding flow")
- A project ID or project name
- Optionally: specific screen IDs
- Optionally: creative range ("refine", "explore", "reimagine")
- Optionally: aspects to focus on ("layout", "color", "images", "text font", "text content")
- Optionally: number of variants (1-5)
- Empty — ask the user what they want to explore
Purpose
This skill generates design variants of existing Stitch screens using generate_variants. It's for exploration — trying different visual approaches, layouts, or content treatments without committing to a direction.
Use this when:
- The generated screen works functionally but the user wants to see alternatives
- The user wants to explore a different visual direction
- The user wants to compare subtle refinements side by side
- A screen could benefit from a radically different approach
Creative Range Guide
Help the user choose the right creative range:
| Range |
What It Does |
When to Use |
| REFINE |
Subtle adjustments — keeps the same basic approach but polishes |
"I like this direction but it could be better" |
| EXPLORE |
Meaningful alternatives — same content, different approaches |
"Show me other ways this could work" (default) |
| REIMAGINE |
Radical rethinking — fundamentally different takes |
"I want something completely different" |
Aspect Focus Guide
When the user has a specific concern, focus the variants:
| Aspect |
What Varies |
When to Use |
| LAYOUT |
Arrangement of elements, spatial hierarchy |
"I want to see different ways to organize this content" |
| COLOR_SCHEME |
Colors, contrast, visual weight |
"I want to explore different color directions" |
| IMAGES |
Image style, selection, treatment |
"I want to see different image approaches" |
| TEXT_FONT |
Typography, font choices, type hierarchy |
"I want to explore different typography" |
| TEXT_CONTENT |
Copy, messaging, content voice |
"I want to try different messaging" |
If no aspects are specified, all aspects may be varied (broader exploration).
Variant Prompt Best Practices
The prompt for generate_variants should describe WHAT DIRECTION to explore, not what the result should look like:
DO:
- Describe the intent — "Explore approaches that emphasize the course content over the instructor details"
- Reference the user's goal — "Find a variant that makes the call-to-action more discoverable for first-time visitors"
- Name what's not working — "The current version feels too dense for the amount of content — find variants with more breathing room"
- Be directional — "Lean toward approaches that prioritize scannability over immersion"
DON'T:
- Don't prescribe the solution — "Make it a two-column layout with the image on the left" defeats the purpose of variants
- Don't specify design details — No colors, fonts, components, or CSS
- Don't be vague — "Make it better" gives Stitch nothing to work with
Prompt Template:
[What the screen currently does well — one sentence].
Explore variants that [direction — what to optimize for, what feeling to target, what concern to address].
[Optional: what aspect matters most — e.g., "Focus on how the information hierarchy could work differently"]
Execution Steps
Step 1 — Identify Target
Call list_projects → find the project
Call list_screens with projectId → find screens
Call get_screen → review current state of target screen(s)
Step 2 — Determine Variant Parameters
Based on the user's request, decide:
- Creative range: REFINE, EXPLORE, or REIMAGINE
- Aspects: Which aspects to focus on (or leave empty for full exploration)
- Count: Number of variants (default 3, max 5)
- Prompt: Directional prompt following best practices
Step 3 — Generate Variants
Call generate_variants with:
projectId: the project ID
selectedScreenIds: array of screen IDs to vary
prompt: the directional prompt
variantOptions:
creativeRange: selected range
aspects: selected aspects (array) or empty
variantCount: number of variants
deviceType: match the original screen's device type
modelId: GEMINI_3_1_PRO (default) or GEMINI_3_FLASH for faster results
Step 4 — Report
## Variants Generated: [Screen Name]
**Direction:** [1-sentence summary of what was explored]
**Creative Range:** [REFINE | EXPLORE | REIMAGINE]
**Aspects:** [focused aspects or "all"]
**Variants:** [count] generated
**Project:** [project ID]
**Source Screen:** [screen ID]
### Next Steps
- Open Stitch to review and compare the variants visually
- Select the preferred variant as your new baseline
- Use `/stitch-iterate` to refine the chosen variant
- Generate additional variants with a different creative range or aspect focus
Common Variant Workflows
"I like it but it could be better"
- Creative range: REFINE
- Aspects: Leave empty (all)
- Count: 3
- Prompt: "Refine this screen — keep the overall approach but improve the polish and clarity"
"Show me layout alternatives"
- Creative range: EXPLORE
- Aspects: [LAYOUT]
- Count: 3-4
- Prompt: "Explore different ways to arrange this content. The current layout [what's working or not working about it]."
"Start over with a different feel"
- Creative range: REIMAGINE
- Aspects: Leave empty (all)
- Count: 3
- Prompt: "Reimagine this screen. The content and functionality should stay the same, but explore fundamentally different approaches to presenting it."
"The content is right, the visuals aren't"
- Creative range: EXPLORE
- Aspects: [COLOR_SCHEME, TEXT_FONT]
- Count: 4
- Prompt: "Keep the content and layout but explore different visual treatments. The current version [what's not working about the visual direction]."
Anti-Patterns
- Don't generate variants of screens you haven't reviewed — Always
get_screen first to understand what you're varying.
- Don't skip the prompt — Even though variants work without a detailed prompt, a directional prompt produces dramatically better results.
- Don't generate too many at once — 3 is the sweet spot. More than 4-5 creates decision fatigue.
- Don't use REIMAGINE when you mean REFINE — Radical exploration is expensive and disorienting when you just need polish.
- Don't prescribe the variant's design — The whole point is letting Stitch explore. Constrain the intent, not the implementation.
Workflow
Part of the Stitch workflow: stitch-build → stitch-iterate → stitch-variants → stitch-export
1---2name: stitch-variants3description: Generate design variants of existing Stitch screens to explore alternative approaches. Controls creative range, aspects to vary, and number of variants.4user-invocable: true5allowed-tools: Read, Write, Edit, Bash, Grep, Glob, mcp__stitch__generate_variants, mcp__stitch__list_projects, mcp__stitch__list_screens, mcp__stitch__get_screen, mcp__stitch__get_project6metadata:7 source: https://skillmd.com/skills/joshuashepherd/stitch-variants8---910Generate variants for Stitch screens: $ARGUMENTS1112$ARGUMENTS should include:13- What to explore (e.g., "try different layouts for the dashboard", "explore color alternatives for the landing page", "reimagine the onboarding flow")14- A project ID or project name15- Optionally: specific screen IDs16- Optionally: creative range ("refine", "explore", "reimagine")17- Optionally: aspects to focus on ("layout", "color", "images", "text font", "text content")18- Optionally: number of variants (1-5)19- Empty — ask the user what they want to explore2021## Purpose2223This skill generates design variants of existing Stitch screens using `generate_variants`. It's for exploration — trying different visual approaches, layouts, or content treatments without committing to a direction.2425Use this when:26- The generated screen works functionally but the user wants to see alternatives27- The user wants to explore a different visual direction28- The user wants to compare subtle refinements side by side29- A screen could benefit from a radically different approach3031## Creative Range Guide3233Help the user choose the right creative range:3435| Range | What It Does | When to Use |36|-------|-------------|-------------|37| **REFINE** | Subtle adjustments — keeps the same basic approach but polishes | "I like this direction but it could be better" |38| **EXPLORE** | Meaningful alternatives — same content, different approaches | "Show me other ways this could work" (default) |39| **REIMAGINE** | Radical rethinking — fundamentally different takes | "I want something completely different" |4041## Aspect Focus Guide4243When the user has a specific concern, focus the variants:4445| Aspect | What Varies | When to Use |46|--------|------------|-------------|47| **LAYOUT** | Arrangement of elements, spatial hierarchy | "I want to see different ways to organize this content" |48| **COLOR_SCHEME** | Colors, contrast, visual weight | "I want to explore different color directions" |49| **IMAGES** | Image style, selection, treatment | "I want to see different image approaches" |50| **TEXT_FONT** | Typography, font choices, type hierarchy | "I want to explore different typography" |51| **TEXT_CONTENT** | Copy, messaging, content voice | "I want to try different messaging" |5253If no aspects are specified, all aspects may be varied (broader exploration).5455## Variant Prompt Best Practices5657The prompt for `generate_variants` should describe WHAT DIRECTION to explore, not what the result should look like:5859### DO:60- **Describe the intent** — "Explore approaches that emphasize the course content over the instructor details"61- **Reference the user's goal** — "Find a variant that makes the call-to-action more discoverable for first-time visitors"62- **Name what's not working** — "The current version feels too dense for the amount of content — find variants with more breathing room"63- **Be directional** — "Lean toward approaches that prioritize scannability over immersion"6465### DON'T:66- **Don't prescribe the solution** — "Make it a two-column layout with the image on the left" defeats the purpose of variants67- **Don't specify design details** — No colors, fonts, components, or CSS68- **Don't be vague** — "Make it better" gives Stitch nothing to work with6970### Prompt Template:71```72[What the screen currently does well — one sentence].7374Explore variants that [direction — what to optimize for, what feeling to target, what concern to address].7576[Optional: what aspect matters most — e.g., "Focus on how the information hierarchy could work differently"]77```7879## Execution Steps8081### Step 1 — Identify Target82```83Call list_projects → find the project84Call list_screens with projectId → find screens85Call get_screen → review current state of target screen(s)86```8788### Step 2 — Determine Variant Parameters89Based on the user's request, decide:90- **Creative range:** REFINE, EXPLORE, or REIMAGINE91- **Aspects:** Which aspects to focus on (or leave empty for full exploration)92- **Count:** Number of variants (default 3, max 5)93- **Prompt:** Directional prompt following best practices9495### Step 3 — Generate Variants96Call `generate_variants` with:97- `projectId`: the project ID98- `selectedScreenIds`: array of screen IDs to vary99- `prompt`: the directional prompt100- `variantOptions`:101 - `creativeRange`: selected range102 - `aspects`: selected aspects (array) or empty103 - `variantCount`: number of variants104- `deviceType`: match the original screen's device type105- `modelId`: GEMINI_3_1_PRO (default) or GEMINI_3_FLASH for faster results106107### Step 4 — Report108```markdown109## Variants Generated: [Screen Name]110111**Direction:** [1-sentence summary of what was explored]112**Creative Range:** [REFINE | EXPLORE | REIMAGINE]113**Aspects:** [focused aspects or "all"]114**Variants:** [count] generated115116**Project:** [project ID]117**Source Screen:** [screen ID]118119### Next Steps120- Open Stitch to review and compare the variants visually121- Select the preferred variant as your new baseline122- Use `/stitch-iterate` to refine the chosen variant123- Generate additional variants with a different creative range or aspect focus124```125126## Common Variant Workflows127128### "I like it but it could be better"129- Creative range: REFINE130- Aspects: Leave empty (all)131- Count: 3132- Prompt: "Refine this screen — keep the overall approach but improve the polish and clarity"133134### "Show me layout alternatives"135- Creative range: EXPLORE136- Aspects: [LAYOUT]137- Count: 3-4138- Prompt: "Explore different ways to arrange this content. The current layout [what's working or not working about it]."139140### "Start over with a different feel"141- Creative range: REIMAGINE142- Aspects: Leave empty (all)143- Count: 3144- Prompt: "Reimagine this screen. The content and functionality should stay the same, but explore fundamentally different approaches to presenting it."145146### "The content is right, the visuals aren't"147- Creative range: EXPLORE148- Aspects: [COLOR_SCHEME, TEXT_FONT]149- Count: 4150- Prompt: "Keep the content and layout but explore different visual treatments. The current version [what's not working about the visual direction]."151152## Anti-Patterns153154- **Don't generate variants of screens you haven't reviewed** — Always `get_screen` first to understand what you're varying.155- **Don't skip the prompt** — Even though variants work without a detailed prompt, a directional prompt produces dramatically better results.156- **Don't generate too many at once** — 3 is the sweet spot. More than 4-5 creates decision fatigue.157- **Don't use REIMAGINE when you mean REFINE** — Radical exploration is expensive and disorienting when you just need polish.158- **Don't prescribe the variant's design** — The whole point is letting Stitch explore. Constrain the intent, not the implementation.159160## Workflow161162Part of the Stitch workflow: stitch-build → stitch-iterate → stitch-variants → stitch-export