widgets-ui — Claude Code skill for JSON-driven React/Next.js widgets
widgets-ui — a skill for Claude Code, Cursor, Codex and other agents: builds React/Next.js components from JSON descriptions. The agent outputs a widget structure; the renderer assembles forms, cards and layouts in the project.
no license 239 installs ★ 31 updated 2026-08-31
npx skills add 101-skills/superpowers --skill widgets-ui -a claude-codeWhat widgets-ui does
The skill connects the widget library from ui.inference.sh via the shadcn registry — npx shadcn@latest add https://ui.inference.sh/r/widgets.json drops a WidgetRenderer component into the project.
Widgets are plain JSON objects. Layout nodes cover row, col and box with named gradients like gradient-ocean and gradient-sunset. Typography includes title, text, caption and label. Interactive elements are button, input, textarea, select and checkbox. Display nodes add badge, icon, image and divider. WidgetRenderer takes a widget tree and an onAction callback that receives the event type and form data — either submit or click.
The component targets the React/Next.js ecosystem, so projects outside it cannot use it.
What it helps with
- generate a contact form from a structured agent response
- render a flight card with icons and a gradient background
- compose a dynamic two-column layout from model output
- add a select or checkbox to an agent UI without writing markup by hand
- handle form submission through the
onActioncallback
Example prompts for the agent
- Generate a registration form widget with
name,emailfields and a Submit button usingWidgetRenderer - Build a product card with a badge, image and Buy button as a JSON widget for
widgets-ui - Create a two-column layout with a heading using declarative
widgets-uiJSON nodes
How to install widgets-ui
1Skills CLI (Vercel)
npx skills add 101-skills/superpowers --skill widgets-ui -a claude-code2Manually: put the files in place
~/.claude/skills/widgets-ui/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/widgets-ui/
1Skills CLI (Vercel)
npx skills add 101-skills/superpowers --skill widgets-ui -a codex2Manually: put the files in place
.agents/skills/widgets-ui/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 101-skills/superpowers --skill widgets-ui -a cursor2Manually: put the files in place
.cursor/skills/widgets-ui/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 101-skills/superpowers ui/widgets-ui/SKILL.md2Manually: put the files in place
.github/skills/widgets-ui/SKILL.md1Skills CLI (Vercel)
npx skills add 101-skills/superpowers --skill widgets-ui -a gemini-cli2Platform CLI
gemini skills install https://github.com/101-skills/superpowers --path ui/widgets-uiManually: put the files in place
.devin/skills/widgets-ui/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add 101-skills/superpowers --skill widgets-ui -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about widgets-ui
How do I install widgets-ui in Claude Code?
Run npx skills add 101-skills/superpowers --skill widgets-ui -a claude-code. The skill will be available at ~/.claude/skills/widgets-ui/SKILL.md.
What does the widgets-ui skill do?
It teaches the agent to produce React/Next.js UIs from JSON — forms, cards, buttons and layouts — rendered by the WidgetRenderer component from ui.inference.sh.
Does the component also need to be installed in the project?
Yes. The skill adds instructions to the agent, but the component itself requires npx shadcn@latest add https://ui.inference.sh/r/widgets.json in each project.