Agent setup

Copy a prompt into your coding agent and let it install, wire and verify Fable UI.

Each prompt is self-contained. It lists prerequisites, the exact commands, the edits to make, and how the agent should verify its work. They work in Claude Code, Cursor, Codex, Windsurf and similar agents.

Prompts

New Next.js app with an AI chat

Creates a working /fable-chat page that answers with rich UI.

Add to an existing AI SDK chat

Keeps your chat UI; adds the render_ui tool and renderer.

Add a custom block

Teaches the model a new component, end to end.

Match my brand

Uses a preset or your shadcn theme.

Agent skill

For agents that support skills, this repository ships one at .agents/skills/fable-ui. It contains the same procedures, the block catalog, and a doctor script that checks an app's setup (Tailwind v4, shadcn, aliases, AI SDK version, the route, the font token).

Install it into your project:

pnpm dlx skills add shobky/fable-ui --skill fable-ui

Or download fable-ui.skill and unzip it into your agent's skills folder.

What a good result looks like

After setup, ask the chat for:

  1. "Compare three databases for a small SaaS" — a sortable table, streamed row by row.
  2. "Help me plan a dinner party — ask what you need" — a form; submitting it sends your answers back.
  3. "Hi!" — plain text. Fable is for structure, not every reply.

If any of these fails, have the agent run the doctor script:

node .agents/skills/fable-ui/scripts/doctor.mjs