variate

Creates and compares real visual design alternatives for one project file, then keeps the selected code.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/oxie/prime-agent-skills --skill variate-oxie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: variate
Source: https://github.com/oxie/prime-agent-skills/tree/main/variate
Command: npx skills add https://github.com/oxie/prime-agent-skills --skill variate-oxie

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Choosing between visual design directions usually means editing a file, eyeballing it, and losing the alternatives. Variate writes each design direction as a complete numbered sibling file, lets you flip between them on the live page, and keeps only the accepted code. ## Core Features & Use Cases - File-based design rounds: Registers one target file per round, drafts 2-4 meaningfully different complete replacements under .variate/<set>/, and switches the live file between positions with variate use. - Optional localhost preview card: A foreground loopback-only sidecar attaches a dev-only comparison card to Next.js, Astro, SvelteKit, Nuxt, Vite, Rails, or plain HTML projects, with Keep/Refine decisions queued for the agent. - Safe cleanup and recovery: Symlink targets are refused, hand edits are archived before narrowing, and variate end verifies saved hashes before deleting unselected alternatives. - Use Case: Ask for four alternative hero sections on your landing page; the agent drafts them, you flip through them in the browser at desktop and 390px widths, keep one, and the rest are removed. ## Quick Start Ask the agent to create four alternative designs for a specific page or component file in your project and preview them with the Variate card.

Frequently Asked Questions about variate

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

FAQPage Schema
How do I compare multiple design alternatives for one file?▼

Register the file with `variate add <file> --root <project>`, which stores the current version as position 1. Write positions 2-4 as complete replacement files under `.variate/<set>/`, then switch between them with `variate use <set> <n>` and keep the winner with `variate end`.

How do I preview design variants in the browser?▼

Run `variate up --root <project>` to start a foreground loopback-only server. It serves plain HTML directly or attaches a dev-only comparison card to recognized framework layouts, letting you flip variants with arrow keys and queue Keep or Refine decisions.

Which frameworks does the Variate preview card support?▼

The card attaches to Next.js (app and pages router), Astro, SvelteKit, Nuxt, Vite, Rails ERB layouts, and plain static HTML. Framework projects keep their own dev server; static projects are served directly by the Variate sidecar.

Does Variate work with symlinked or hidden project files?▼

No. Symlinked target, scratch, and attachment paths are refused rather than followed, and hidden files cannot be registered as targets. This protects against escaping the canonical project root during switching and cleanup.

What happens to unselected design variants after I decide?▼

The `variate end` command verifies the kept file's saved hashes, acknowledges the decision, and permanently deletes unselected alternatives and recovery archives. Keep a Git baseline or external backup if you need longer-term comparison history.

When should I not use Variate for a design change?▼

Skip it for a single obvious edit, nonvisual refactoring, statistical A/B testing, or unattended design work. It is built for comparing multiple complete visual directions of one file with an active user making the decision.