VibeRPGSimulator

Reads components.json, then finds, composes, and adds shadcn components with the CLI.

How it works

Foe: Blank Mimic, an empty screen or canvas that needs a design.

Foes

  • Blank Mimic

Party · Context

  • IllusionistYour agent100/100

  1. Blank Mimic

    The Blank Mimic blocks the way.

    What really happensIt stands for an empty screen or canvas that needs a design.

    Illusionist: Context 100/100.

  2. Blank stare

    The blank page stares back and drains the hero.

    What really happensStarting a screen from nothing costs time and context.

    Illusionist takes 9. Illusionist: Context 91/100.

  3. shadcn Skill

    The hero reads the shadcn scroll and the project's own ledger.

    What really happensThe skill runs npx shadcn@latest info --json and loads framework, aliases, base, icons, and installed components.

    Blank Mimic takes 21.

  4. shadcn Skill

    It searches the registry before forging a custom piece.

    What really happensIt uses shadcn search and shadcn docs before writing UI, and asks which registry to use if you did not name one.

    Blank Mimic takes 18.

  5. Blank stare

    The Blank Mimic uses Blank stare.

    Illusionist takes 9. Illusionist: Context 82/100.

  6. shadcn Skill

    Forms, cards, and dialogs are composed from the project's base.

    What really happensIt adds components with the CLI, then checks composition rules such as FieldGroup for forms and a title on every dialog.

    Blank Mimic takes 26.

  7. shadcn Skill

    The Blank Mimic is built from this project's own components.

    What really happensYou get shadcn source that matches components.json, including preset apply or merge when you ask to switch presets.

    Blank Mimic takes 35. Blank Mimic falls.

  8. Victory

    The Blank Mimic falls.

Learn this spell

Claude Code and Codex

npx skills add shadcn/ui

Notes

Install with npx skills add shadcn/ui. On load it runs shadcn info --json for framework, aliases, base, icons, and installed components. It will not guess a registry when you ask to add a block. Preset changes ask whether to overwrite, partially apply, merge, or skip. allowed-tools in the frontmatter is a Claude Code extension. Other agents may ignore it. The project must be able to run the shadcn CLI.

Records

Recorded use7root sessions
Test recoveries6 of 6sessions with a failing test

Curator's machine: macOS 27.0.1 · Apple Silicon (arm64), read when these stats were published. Session logs do not record the OS.

Sessions per month

602026-09: 6 sessions2026-092026-10: 1 session2026-10
View data
Sessions per month
MonthSessions
2026-096
2026-101

Harness

Codex: 3 sessionsOMP: 4 sessions
  • Codex3 (43%)Version 0.155.0-alpha.2.6 in the first session, 0.154.0 in the latest
  • OMP4 (57%)Version not in its logs; 18.8.3 installed when published
View data
Sessions by harness
HarnessSessionsVersion
Codex3Version 0.155.0-alpha.2.6 in the first session, 0.154.0 in the latest
OMP4Version not in its logs; 18.8.3 installed when published

Often used with

View data
Spells often used with shadcn Skill
ItemSessions
Matt Pocock TDD7
Supabase Postgres Best Practices4
Chrome DevTools MCP1

What a recovery means

A failed test was followed by a passing test of the same runner family in one session. It does not prove this spell caused the fix.

First recorded: . Most recent: .