Generate to diverge, code to converge — prompts and exercises

Complete reusable prompts, setup recipes, success checks, and caveats for generate to diverge, code to converge.

Complete reusable prompts, setup recipes, success checks, and caveats for generate to diverge, code to converge.

Quick start

Fastest possible taste — 9 website mockups landing in ./mockups/ (needs the Codex CLI; the agy version is in the prompt library):

Before you run it: this launches Codex — a paid agent — with sandboxing and approval prompts disabled (--dangerously-bypass-approvals-and-sandbox). Read the command first and run it only in a project where you're comfortable with the cost and with an unsandboxed agent writing files.

mkdir -p mockups
codex exec --dangerously-bypass-approvals-and-sandbox 'Use the $imagegen skill to generate 9 WILDLY different website homepage mockups for a landing page for an indie coffee roaster. The subject stays identical in all 9 - ONLY the visual style varies. One built-in image_gen call per mockup. After each image completes, copy it from $CODEX_HOME/generated_images/ into ./mockups/ as mockup-01.png ... mockup-09.png. Announce progress after each one.'
ls mockups/

Prompt library

The first two prompts use a {{SUBJECT}} placeholder — replace it before pasting, or let the run scripts (below) substitute it for you. Keep the subject identical across all 9; that's what makes the results comparable.

Codex — 9x wildly different website mockups

  • Agent: Codex CLI ($imagegen skill)
  • Working directory: your project root
  • Expected result: mockups/mockup-01.png … mockup-09.png + 9 named style directions
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.

agy (Antigravity) — 9x wildly different mobile mockups

  • Agent: agy (Google Antigravity CLI)
  • Working directory: your project root
  • Expected result: mockups/mockup-01.png … mockup-09.png, phone aspect, 9 named directions
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.

JSON status contract — for scripting image gen at scale

  • Agent: any image-gen agent driven from bash
  • Working directory: append to your generation prompt
  • Expected result: one parseable JSON line per run — this is how inspiration-board loops over 200 styles unattended
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>"}

Converge — rebuild the winner as real code

  • Agent: Codex or Claude Code
  • Working directory: project root, after picking a winner (replace 0N)
  • Expected result: winner/index.html — real text and layout, no bitmap backgrounds
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.

Set it up (agent guide)

  1. Create the Codex prompt file. The run script extracts its 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.
    ```
    
  2. Create the agy prompt file (same pattern, mobile mockups, plus the scripted status contract).

    # 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 the Codex run script.

    #!/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 the agy run script (note it raises --print-timeout to 15m — the 5m default is too short for 9 images).

    #!/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 the contact-sheet gallery. It polls every 5 seconds, so tiles fill in live while the run generates.

    <!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 and fire a run (background it — 9 images take a few minutes):

    chmod +x scripts/run-codex-mockups.sh scripts/run-agy-mockups.sh
    ./scripts/run-codex-mockups.sh "a landing page for an indie coffee roaster"
    # or, for mobile:
    ./scripts/run-agy-mockups.sh "a mobile app for selling houses"
    

Success check: nine numbered PNGs exist and the gallery shows nine tiles — same subject, nine styles.

ls mockups/mockup-0*.png
open mockups/index.html   # macOS; use xdg-open on Linux
mockups/mockup-01.png  mockups/mockup-02.png  mockups/mockup-03.png
mockups/mockup-04.png  mockups/mockup-05.png  mockups/mockup-06.png
mockups/mockup-07.png  mockups/mockup-08.png  mockups/mockup-09.png

Attachments — install the page skill

This is the exact here-now-workshop-page skill — with the Elo-voted Instrument Panel theme — that built every page in this workshop, published on this site byte-for-byte (SKILL.md plus its four templates/ files). Download all five, then npx skills copies the whole folder into your project's .agents/skills/, templates/ included. Two tested gotchas are baked in: .md URLs on here.now serve an HTML viewer, so the two markdown files must be fetched with ?raw; and the download is staged in ./page-skill/, not ./skills/ — the installer treats an existing ./skills/ as an agent's project skill dir and will clobber your download with a symlink.

mkdir -p page-skill/here-now-workshop-page/templates
curl -fsSL -o page-skill/here-now-workshop-page/SKILL.md "https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/SKILL.md?raw"
curl -fsSL -o page-skill/here-now-workshop-page/templates/agent.md "https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/agent.md?raw"
curl -fsSL -o page-skill/here-now-workshop-page/templates/index.html "https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/index.html"
curl -fsSL -o page-skill/here-now-workshop-page/templates/styles.css "https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/styles.css"
curl -fsSL -o page-skill/here-now-workshop-page/templates/app.js "https://indigo-kayak-2zw8.here.now/skills/here-now-workshop-page/templates/app.js"
npx skills add ./page-skill --skill here-now-workshop-page -y

Complete reusable setup contract

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:

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):
# 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.
```
  1. Create 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).
  1. Create 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"
  1. Create 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
  1. Create 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>
  1. Make the scripts executable:
chmod +x scripts/run-codex-mockups.sh scripts/run-agy-mockups.sh
  1. 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.
# 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:

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):

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):

Source references