Following this file sets up: a 9x design-mockup generator in the user's current project — two prompt files, two run scripts, and a live-updating contact-sheet gallery. One command then generates nine wildly different mockups (same subject, nine styles) into mockups/.
Placeholders used below: <project-root> = the project you are working in. All other paths are literal and relative to <project-root>.
Check each before starting:
command -v codex && codex --version
command -v agy && agy --version
Expected: at least ONE of the two prints a version. codex (OpenAI Codex CLI) drives the website-mockup script; agy (Google Antigravity CLI) drives the mobile-mockup script. If both are missing, stop and tell your user what to install. Also confirm you are in <project-root> and it is writable.
prompts/codex-9x-website.md with exactly this content (the run script extracts the first fenced block and substitutes the subject):# Codex prompt — 9x wildly different website mockups
Replace `{{SUBJECT}}` with the site you're designing (keep it constant across all 9!).
```
Use the $imagegen skill to generate 9 WILDLY different website homepage mockups
for {{SUBJECT}}.
Rules:
- The SUBJECT stays identical in all 9 — same product, same page type
(homepage), same rough content (hero, nav, one CTA). ONLY the visual style
varies. This is what makes them comparable.
- Pick 9 maximally divergent directions, e.g.: swiss/international typographic,
neo-brutalist, glassmorphic dark, editorial magazine, retro terminal,
playful memphis, luxury minimal, bento-grid dashboard, hand-drawn zine.
Name each direction before generating.
- One built-in image_gen call per mockup (do NOT drop to the CLI fallback).
- Desktop aspect, full homepage visible, legible headline text.
- After each image completes, copy it from $CODEX_HOME/generated_images/
into ./mockups/ as mockup-01.png ... mockup-09.png (match the direction
order you announced).
- Announce progress after each one — never go silent.
- When all 9 exist, list the 9 directions next to their filenames.
```
## Follow-up (converge on a winner)
```
mockup-0N.png is the winner. Rebuild it as a real single-file HTML/CSS page at
./winner/index.html, using the image strictly as a visual reference — real
text, real layout, no bitmap backgrounds.
```
prompts/agy-9x-mobile.md with exactly this content:# agy (Antigravity) prompt — 9x wildly different mobile mockups
Replace `{{SUBJECT}}` with the app you're designing. Historical workshop subject:
"a mobile app for selling houses".
```
Generate 9 WILDLY different mobile app UI mockups for {{SUBJECT}} using your
generate_image tool.
Rules:
- SUBJECT is constant across all 9 — same app, same home screen (listing feed,
search, one primary action). ONLY the visual style varies.
- 9 divergent directions, e.g.: iOS glass minimal, material-you expressive,
neo-brutalist, dark luxury, pastel neumorphic, retro pixel, editorial serif,
cyberpunk neon, paper-collage tactile. Name each before generating.
- One generate_image call per mockup with ImageName mockup_01 ... mockup_09.
- Phone aspect ratio (9:19-ish), single screen per image.
- After each generation, use run_command to copy the artifact into
./mockups/ as mockup-01.png ... mockup-09.png.
- If you hit an image quota error, report it immediately with the reset time
instead of retrying silently.
- Announce progress after each image.
```
## Scripted status contract (from the inspiration-board pipeline)
When driving agy from bash at scale, demand machine-readable status:
```
Respond with ONLY a JSON object (no markdown, no explanation):
- Success: {"status":"ok","path":"<output_path>"}
- Quota error: {"status":"quota_exhausted","reset_seconds":<N>,"reset_time":"<ISO8601>"}
- Other error: {"status":"error","message":"<description>"}
```
This is the exact contract `generate.sh` in the inspiration-board pipeline uses
to loop over 200 styles unattended, with a skip-if-exists guard (file > 100KB).
scripts/run-codex-mockups.sh with exactly this content:#!/bin/bash
# Fire Codex $imagegen: 9 wildly different website mockups for one subject.
# Usage: ./scripts/run-codex-mockups.sh "a landing page for an indie coffee roaster"
set -euo pipefail
SUBJECT="${1:?usage: $0 \"<subject, e.g. a landing page for an indie coffee roaster>\"}"
DIR="$(cd "$(dirname "$0")/.." && pwd)"
mkdir -p "$DIR/mockups"
# Extract the first fenced block from the prompt file, substitute the subject.
PROMPT="$(sed "s/{{SUBJECT}}/$(printf '%s' "$SUBJECT" | sed 's/[&/\]/\\&/g')/g" "$DIR/prompts/codex-9x-website.md" \
| awk '/^```/{f++;next} f==1')"
echo "── codex \$imagegen → 9 mockups for: $SUBJECT"
echo "── output: $DIR/mockups/mockup-0{1..9}.png (watch mockups/index.html)"
cd "$DIR"
codex exec --dangerously-bypass-approvals-and-sandbox "$PROMPT"
scripts/run-agy-mockups.sh with exactly this content:#!/bin/bash
# Fire agy (Google Antigravity CLI): 9 wildly different mobile mockups for one subject.
# Usage: ./scripts/run-agy-mockups.sh "a mobile app for selling houses"
set -euo pipefail
SUBJECT="${1:?usage: $0 \"<subject, e.g. a mobile app for selling houses>\"}"
DIR="$(cd "$(dirname "$0")/.." && pwd)"
mkdir -p "$DIR/mockups"
# Extract the first fenced block from the prompt file, substitute the subject.
PROMPT="$(sed "s/{{SUBJECT}}/$(printf '%s' "$SUBJECT" | sed 's/[&/\]/\\&/g')/g" "$DIR/prompts/agy-9x-mobile.md" \
| awk '/^```/{f++;next} f==1')"
echo "── agy generate_image → 9 mobile mockups for: $SUBJECT"
echo "── output: $DIR/mockups/mockup-0{1..9}.png (watch mockups/index.html)"
cd "$DIR"
agy -p "$PROMPT" --dangerously-skip-permissions --print-timeout 15m
mockups/index.html with exactly this content (it polls every 5 seconds so tiles fill in live during generation):<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>9x Mockup Contact Sheet</title>
<style>
:root { color-scheme: dark; }
body { margin: 0; font: 14px/1.4 ui-sans-serif, system-ui; background: #0d0f12; color: #e8e6e1; }
header { padding: 20px 24px 8px; display: flex; align-items: baseline; gap: 12px; }
h1 { font-size: 18px; margin: 0; letter-spacing: .02em; }
header span { color: #8a8f98; font-size: 12px; }
.grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; padding: 16px 24px 32px; }
figure { margin: 0; background: #16191e; border: 1px solid #262b33; border-radius: 10px; overflow: hidden; }
.frame { aspect-ratio: 4 / 3; display: grid; place-items: center; background:
repeating-conic-gradient(#14171c 0% 25%, #101318 0% 50%) 50% / 24px 24px; }
.frame img { width: 100%; height: 100%; object-fit: cover; display: block; }
.frame .empty { color: #4a5058; font-size: 12px; text-align: center; padding: 12px; }
figcaption { padding: 8px 12px; color: #b8bdc4; font-size: 12px; display: flex; justify-content: space-between; }
figcaption b { color: #e8e6e1; font-weight: 600; }
.frame img:hover { cursor: zoom-in; }
dialog { border: 0; padding: 0; background: transparent; max-width: 92vw; }
dialog img { max-width: 92vw; max-height: 92vh; border-radius: 8px; }
dialog::backdrop { background: rgba(0,0,0,.8); }
</style>
</head>
<body>
<header>
<h1>9x Wildly Different Mockups</h1>
<span>same subject · nine styles · auto-refreshes every 5s while generating</span>
</header>
<div class="grid" id="grid"></div>
<dialog id="zoom"><img id="zoomimg" alt=""></dialog>
<script>
const grid = document.getElementById('grid');
const zoom = document.getElementById('zoom');
const zoomimg = document.getElementById('zoomimg');
for (let i = 1; i <= 9; i++) {
const n = String(i).padStart(2, '0');
const fig = document.createElement('figure');
fig.innerHTML = `
<div class="frame" data-n="${n}"><div class="empty">mockup-${n}.png<br>waiting…</div></div>
<figcaption><b>#${n}</b><span class="dir" data-n="${n}"></span></figcaption>`;
grid.appendChild(fig);
}
function tryLoad() {
document.querySelectorAll('.frame').forEach(frame => {
if (frame.querySelector('img')) return;
const n = frame.dataset.n;
const img = new Image();
img.src = `mockup-${n}.png?t=${Date.now()}`;
img.onload = () => {
frame.innerHTML = '';
frame.appendChild(img);
img.addEventListener('click', () => { zoomimg.src = img.src; zoom.showModal(); });
};
});
}
zoom.addEventListener('click', () => zoom.close());
tryLoad();
setInterval(tryLoad, 5000);
</script>
</body>
</html>
chmod +x scripts/run-codex-mockups.sh scripts/run-agy-mockups.sh
--dangerously-bypass-approvals-and-sandbox for codex, --dangerously-skip-permissions for agy). Show your user the command and make sure they are comfortable with the cost and permissions before running. Then fire a run. Prefer running it in the background and narrating progress; a full run takes several minutes.# website mockups via Codex:
./scripts/run-codex-mockups.sh "a landing page for an indie coffee roaster"
# OR mobile mockups via agy:
./scripts/run-agy-mockups.sh "a mobile app for selling houses"
Run:
ls mockups/mockup-0*.png
open mockups/index.html # macOS; use xdg-open on Linux
Expected observable result: nine files, mockups/mockup-01.png through mockups/mockup-09.png, and the gallery page shows nine filled tiles — the same subject rendered in nine different visual styles.
Report to your user: the subject used, the nine style directions the generating agent announced, the success-check output, and anything you had to adapt.
image_gen output lands under $CODEX_HOME/generated_images/. The prompt explicitly orders a copy into ./mockups/ — if tiles stay empty but the run "succeeded", look there and copy manually.--print-timeout defaults to 5 minutes — too short for 9 images. The run script already passes --print-timeout 15m; keep it if you modify the script.quota_exhausted, report the reset time to your user instead of retrying silently. For scripted loops, demand the JSON status contract shown at the bottom of prompts/agy-9x-mobile.md.The skill that built this page — SKILL.md plus its templates/ folder, carrying the Elo-voted Instrument Panel theme — is published on this site byte-for-byte. Gotcha: bare .md URLs serve here.now's HTML viewer; the two markdown files MUST be fetched with ?raw (the .html/.css/.js files serve raw bytes as-is):
To install it in a project: download all five into ./page-skill/here-now-workshop-page/ (keeping the templates/ subfolder), then run npx skills add ./page-skill --skill here-now-workshop-page -y — it copies the whole folder, templates included, into ./.agents/skills/here-now-workshop-page/. Do NOT stage the download in ./skills/ — the installer treats an existing ./skills/ as an agent's project skill dir and overwrites the staged folder with a symlink, leaving an empty install (verified empirically). The exact command block is on the guide page under "Attachments — install the page skill".
Human-readable version of this guide: https://indigo-kayak-2zw8.here.now/
Presentation companions (for humans; no setup steps beyond this file):
# Variations: 9x Mockups from One Prompt — agent setup guide
Following this file sets up: a 9x design-mockup generator in the user's current project — two prompt files, two run scripts, and a live-updating contact-sheet gallery. One command then generates nine wildly different mockups (same subject, nine styles) into `mockups/`.
Placeholders used below: `<project-root>` = the project you are working in. All other paths are literal and relative to `<project-root>`.
## Prerequisites
Check each before starting:
```bash
command -v codex && codex --version
command -v agy && agy --version
```
Expected: at least ONE of the two prints a version. `codex` (OpenAI Codex CLI) drives the website-mockup script; `agy` (Google Antigravity CLI) drives the mobile-mockup script. If both are missing, stop and tell your user what to install. Also confirm you are in `<project-root>` and it is writable.
## Steps
1. Create `prompts/codex-9x-website.md` with exactly this content (the run script extracts the first fenced block and substitutes the subject):
````markdown
# Codex prompt — 9x wildly different website mockups
Replace `{{SUBJECT}}` with the site you're designing (keep it constant across all 9!).
```
Use the $imagegen skill to generate 9 WILDLY different website homepage mockups
for {{SUBJECT}}.
Rules:
- The SUBJECT stays identical in all 9 — same product, same page type
(homepage), same rough content (hero, nav, one CTA). ONLY the visual style
varies. This is what makes them comparable.
- Pick 9 maximally divergent directions, e.g.: swiss/international typographic,
neo-brutalist, glassmorphic dark, editorial magazine, retro terminal,
playful memphis, luxury minimal, bento-grid dashboard, hand-drawn zine.
Name each direction before generating.
- One built-in image_gen call per mockup (do NOT drop to the CLI fallback).
- Desktop aspect, full homepage visible, legible headline text.
- After each image completes, copy it from $CODEX_HOME/generated_images/
into ./mockups/ as mockup-01.png ... mockup-09.png (match the direction
order you announced).
- Announce progress after each one — never go silent.
- When all 9 exist, list the 9 directions next to their filenames.
```
## Follow-up (converge on a winner)
```
mockup-0N.png is the winner. Rebuild it as a real single-file HTML/CSS page at
./winner/index.html, using the image strictly as a visual reference — real
text, real layout, no bitmap backgrounds.
```
````
2. Create `prompts/agy-9x-mobile.md` with exactly this content:
````markdown
# agy (Antigravity) prompt — 9x wildly different mobile mockups
Replace `{{SUBJECT}}` with the app you're designing. Historical workshop subject:
"a mobile app for selling houses".
```
Generate 9 WILDLY different mobile app UI mockups for {{SUBJECT}} using your
generate_image tool.
Rules:
- SUBJECT is constant across all 9 — same app, same home screen (listing feed,
search, one primary action). ONLY the visual style varies.
- 9 divergent directions, e.g.: iOS glass minimal, material-you expressive,
neo-brutalist, dark luxury, pastel neumorphic, retro pixel, editorial serif,
cyberpunk neon, paper-collage tactile. Name each before generating.
- One generate_image call per mockup with ImageName mockup_01 ... mockup_09.
- Phone aspect ratio (9:19-ish), single screen per image.
- After each generation, use run_command to copy the artifact into
./mockups/ as mockup-01.png ... mockup-09.png.
- If you hit an image quota error, report it immediately with the reset time
instead of retrying silently.
- Announce progress after each image.
```
## Scripted status contract (from the inspiration-board pipeline)
When driving agy from bash at scale, demand machine-readable status:
```
Respond with ONLY a JSON object (no markdown, no explanation):
- Success: {"status":"ok","path":"<output_path>"}
- Quota error: {"status":"quota_exhausted","reset_seconds":<N>,"reset_time":"<ISO8601>"}
- Other error: {"status":"error","message":"<description>"}
```
This is the exact contract `generate.sh` in the inspiration-board pipeline uses
to loop over 200 styles unattended, with a skip-if-exists guard (file > 100KB).
````
3. Create `scripts/run-codex-mockups.sh` with exactly this content:
```bash
#!/bin/bash
# Fire Codex $imagegen: 9 wildly different website mockups for one subject.
# Usage: ./scripts/run-codex-mockups.sh "a landing page for an indie coffee roaster"
set -euo pipefail
SUBJECT="${1:?usage: $0 \"<subject, e.g. a landing page for an indie coffee roaster>\"}"
DIR="$(cd "$(dirname "$0")/.." && pwd)"
mkdir -p "$DIR/mockups"
# Extract the first fenced block from the prompt file, substitute the subject.
PROMPT="$(sed "s/{{SUBJECT}}/$(printf '%s' "$SUBJECT" | sed 's/[&/\]/\\&/g')/g" "$DIR/prompts/codex-9x-website.md" \
| awk '/^```/{f++;next} f==1')"
echo "── codex \$imagegen → 9 mockups for: $SUBJECT"
echo "── output: $DIR/mockups/mockup-0{1..9}.png (watch mockups/index.html)"
cd "$DIR"
codex exec --dangerously-bypass-approvals-and-sandbox "$PROMPT"
```
4. Create `scripts/run-agy-mockups.sh` with exactly this content:
```bash
#!/bin/bash
# Fire agy (Google Antigravity CLI): 9 wildly different mobile mockups for one subject.
# Usage: ./scripts/run-agy-mockups.sh "a mobile app for selling houses"
set -euo pipefail
SUBJECT="${1:?usage: $0 \"<subject, e.g. a mobile app for selling houses>\"}"
DIR="$(cd "$(dirname "$0")/.." && pwd)"
mkdir -p "$DIR/mockups"
# Extract the first fenced block from the prompt file, substitute the subject.
PROMPT="$(sed "s/{{SUBJECT}}/$(printf '%s' "$SUBJECT" | sed 's/[&/\]/\\&/g')/g" "$DIR/prompts/agy-9x-mobile.md" \
| awk '/^```/{f++;next} f==1')"
echo "── agy generate_image → 9 mobile mockups for: $SUBJECT"
echo "── output: $DIR/mockups/mockup-0{1..9}.png (watch mockups/index.html)"
cd "$DIR"
agy -p "$PROMPT" --dangerously-skip-permissions --print-timeout 15m
```
5. Create `mockups/index.html` with exactly this content (it polls every 5 seconds so tiles fill in live during generation):
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>9x Mockup Contact Sheet</title>
<style>
:root { color-scheme: dark; }
body { margin: 0; font: 14px/1.4 ui-sans-serif, system-ui; background: #0d0f12; color: #e8e6e1; }
header { padding: 20px 24px 8px; display: flex; align-items: baseline; gap: 12px; }
h1 { font-size: 18px; margin: 0; letter-spacing: .02em; }
header span { color: #8a8f98; font-size: 12px; }
.grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; padding: 16px 24px 32px; }
figure { margin: 0; background: #16191e; border: 1px solid #262b33; border-radius: 10px; overflow: hidden; }
.frame { aspect-ratio: 4 / 3; display: grid; place-items: center; background:
repeating-conic-gradient(#14171c 0% 25%, #101318 0% 50%) 50% / 24px 24px; }
.frame img { width: 100%; height: 100%; object-fit: cover; display: block; }
.frame .empty { color: #4a5058; font-size: 12px; text-align: center; padding: 12px; }
figcaption { padding: 8px 12px; color: #b8bdc4; font-size: 12px; display: flex; justify-content: space-between; }
figcaption b { color: #e8e6e1; font-weight: 600; }
.frame img:hover { cursor: zoom-in; }
dialog { border: 0; padding: 0; background: transparent; max-width: 92vw; }
dialog img { max-width: 92vw; max-height: 92vh; border-radius: 8px; }
dialog::backdrop { background: rgba(0,0,0,.8); }
</style>
</head>
<body>
<header>
<h1>9x Wildly Different Mockups</h1>
<span>same subject · nine styles · auto-refreshes every 5s while generating</span>
</header>
<div class="grid" id="grid"></div>
<dialog id="zoom"><img id="zoomimg" alt=""></dialog>
<script>
const grid = document.getElementById('grid');
const zoom = document.getElementById('zoom');
const zoomimg = document.getElementById('zoomimg');
for (let i = 1; i <= 9; i++) {
const n = String(i).padStart(2, '0');
const fig = document.createElement('figure');
fig.innerHTML = `
<div class="frame" data-n="${n}"><div class="empty">mockup-${n}.png<br>waiting…</div></div>
<figcaption><b>#${n}</b><span class="dir" data-n="${n}"></span></figcaption>`;
grid.appendChild(fig);
}
function tryLoad() {
document.querySelectorAll('.frame').forEach(frame => {
if (frame.querySelector('img')) return;
const n = frame.dataset.n;
const img = new Image();
img.src = `mockup-${n}.png?t=${Date.now()}`;
img.onload = () => {
frame.innerHTML = '';
frame.appendChild(img);
img.addEventListener('click', () => { zoomimg.src = img.src; zoom.showModal(); });
};
});
}
zoom.addEventListener('click', () => zoom.close());
tryLoad();
setInterval(tryLoad, 5000);
</script>
</body>
</html>
```
6. Make the scripts executable:
```bash
chmod +x scripts/run-codex-mockups.sh scripts/run-agy-mockups.sh
```
7. Ask your user for a subject if they haven't given one (one sentence, naming the page type and its content — the subject must stay constant across all 9 mockups). **Warning — confirm before firing:** both scripts launch a paid external agent with sandboxing and approval prompts disabled (`--dangerously-bypass-approvals-and-sandbox` for codex, `--dangerously-skip-permissions` for agy). Show your user the command and make sure they are comfortable with the cost and permissions before running. Then fire a run. Prefer running it in the background and narrating progress; a full run takes several minutes.
```bash
# website mockups via Codex:
./scripts/run-codex-mockups.sh "a landing page for an indie coffee roaster"
# OR mobile mockups via agy:
./scripts/run-agy-mockups.sh "a mobile app for selling houses"
```
## Success check
Run:
```bash
ls mockups/mockup-0*.png
open mockups/index.html # macOS; use xdg-open on Linux
```
Expected observable result: nine files, `mockups/mockup-01.png` through `mockups/mockup-09.png`, and the gallery page shows nine filled tiles — the same subject rendered in nine different visual styles.
Report to your user: the subject used, the nine style directions the generating agent announced, the success-check output, and anything you had to adapt.
## Notes for agents
- **Codex saves images to the wrong place by default.** Built-in `image_gen` output lands under `$CODEX_HOME/generated_images/`. The prompt explicitly orders a copy into `./mockups/` — if tiles stay empty but the run "succeeded", look there and copy manually.
- **agy's `--print-timeout` defaults to 5 minutes** — too short for 9 images. The run script already passes `--print-timeout 15m`; keep it if you modify the script.
- **Quota errors are real on agy.** If a run reports `quota_exhausted`, report the reset time to your user instead of retrying silently. For scripted loops, demand the JSON status contract shown at the bottom of `prompts/agy-9x-mobile.md`.
- **Never go silent.** A prior run stalled without output and the user had to ask "hello? What is happening?" — narrate progress after each image, or background the run and poll.
- **Subject drift ruins comparability.** If a mockup comes back as a different page type, regenerate that one; do not compare it.
- **Converge afterwards.** When the user picks a winner, rebuild it with: "mockup-0N.png is the winner. Rebuild it as a real single-file HTML/CSS page at ./winner/index.html, using the image strictly as a visual reference — real text, real layout, no bitmap backgrounds."
## Attachment: the here-now-workshop-page skill (multi-file)
The skill that built this page — SKILL.md plus its `templates/` folder, carrying the Elo-voted Instrument Panel theme — is published on this site byte-for-byte. Gotcha: bare `.md` URLs serve here.now's HTML viewer; the two markdown files MUST be fetched with `?raw` (the .html/.css/.js files serve raw bytes as-is):
- https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/SKILL.md?raw
- https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/agent.md?raw
- https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/index.html
- https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/styles.css
- https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/app.js
To install it in a project: download all five into `./page-skill/here-now-workshop-page/` (keeping the `templates/` subfolder), then run `npx skills add ./page-skill --skill here-now-workshop-page -y` — it copies the whole folder, templates included, into `./.agents/skills/here-now-workshop-page/`. Do NOT stage the download in `./skills/` — the installer treats an existing `./skills/` as an agent's project skill dir and overwrites the staged folder with a symlink, leaving an empty install (verified empirically). The exact command block is on the guide page under "Attachments — install the page skill".
---
Human-readable version of this guide: https://indigo-kayak-2zw8.here.now/
Presentation companions (for humans; no setup steps beyond this file):
- https://indigo-kayak-2zw8.here.now/replay.html — Session Replay: an annotated transcript of the real sessions behind this workflow (diverge → pick with eyes → converge).
- https://indigo-kayak-2zw8.here.now/dialogue.html — Socratic Dialogue: skeptical Q&A that lands the same prompts where each question demands them.