wireframe-skill — Claude Code skill: wireframes from a text brief
Turns a written screen description into a wireframe: a JSON structure plus one HTML preview where blocks can be dragged around.
MIT 206 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill wireframe-skill -a claude-codeWhat wireframe-skill does
Describe a screen in words and the skill lays it out as a wireframe. You get two files: .wireframe.json holding the structure a program can read, and a single HTML file you open in a browser to poke at the result. In that preview blocks move by dragging, copy and paste works, and the edit history steps back and forth.
A python3 one-liner builds the HTML preview, so Python 3 has to be on the machine, and a browser is needed to view it. No design tool sign-in. The skill can also pick up an existing spec at designs/{design-id}/output/design-spec.md and work from that layout instead of a description.
It fits the lo-fi stage, before visual design exists. One catch: claude-wireframe-skill installs into the same wireframe folder, so having both means the later install replaces the earlier one. Colour and typography work needs a different tool.
What it helps with
- sketch a checkout screen before visual design starts
- reorder blocks by dragging and undo the change
- get the wireframe structure as JSON for other tooling
- turn an existing design spec into a layout
- hand someone a single HTML file they can click through
Example prompts for the agent
- Sketch a catalog page as a wireframe: header, filters on the left, card grid.
- Turn
designs/{design-id}/output/design-spec.mdinto a wireframe with a preview. - Give me the cart page as a JSON wireframe plus an HTML preview where blocks can be dragged.
How to install wireframe-skill
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill wireframe-skill -a claude-code2Manually: put the files in place
~/.claude/skills/wireframe-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wireframe-skill/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill wireframe-skill -a codex2Manually: put the files in place
.agents/skills/wireframe-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill wireframe-skill -a cursor2Manually: put the files in place
.cursor/skills/wireframe-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/wireframe-skill2Manually: put the files in place
.github/skills/wireframe-skill/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill wireframe-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/wireframe-skillManually: put the files in place
.devin/skills/wireframe-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill wireframe-skill -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 wireframe-skill
How to install wireframe-skill in Claude Code?
Run npx skills add podo/design-agent-skills --skill wireframe-skill -a claude-code. The skill file lands at ~/.claude/skills/wireframe-skill/SKILL.md.
What is wireframe-skill?
It builds a wireframe from a UI description and returns .wireframe.json along with an interactive HTML preview where elements can be reordered, copied, deleted and undone.
What does it need to run?
Python 3, because the HTML preview is assembled with a python3 one-liner, and a browser to open that preview.
Source text
SKILL.md · MIT
---
name: wireframe-skill
description: |
Generates wireframes from natural language descriptions, outputting machine-readable
JSON (.wireframe.json) and a self-contained interactive HTML preview with drag-and-drop
reordering and undo/redo. Needs Python 3 and a browser, no design tool accounts.
triggers:
- "wireframe-skill"
- "yhassy wireframe"
- "JSON wireframe"
- "interactive wireframe HTML"
das:
type: skill
category: diagrams
upstream: "https://github.com/yhassy/wireframe-skill"
upstream_path: "SKILL.md"
version: latest
install: true
---
# wireframe-skill
> Catalogue stub — full skill: [yhassy/wireframe-skill](https://github.com/yhassy/wireframe-skill)
<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree
1. **Is the full skill already installed?**
Upstream names this skill `wireframe`, so it installs next to this pointer (the pointer is not replaced).
- Global: `f=~/.agents/skills/wireframe/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
- Project: `f=.agents/skills/wireframe/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
- `installed` → the skill is installed as `wireframe`, invoke it and proceed
- `pointer` → go to step 2
2. **Detect scope, then install:**
```bash
[ -e ~/.agents/skills/wireframe-skill ] && echo "global" || echo "project"
```
**Global:**
```bash
npx skills add yhassy/wireframe-skill --skill wireframe -g -y
```
**Project:**
```bash
npx skills add yhassy/wireframe-skill --skill wireframe -y
```
> **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.
**Heads-up**
- **Requires:** Python 3 (the skill assembles the HTML preview with a python3 one-liner) and a browser to open the preview
- **License:** MIT
- **Name collision:** `wireframe` is also written by `claude-wireframe-skill` (its install or its catalogue pointer); installing both overwrites the earlier one.
<!-- das:install:end -->
## Invoke after install
Skill name: `wireframe`, triggers: "wireframe-skill", "yhassy wireframe", "JSON wireframe", "interactive wireframe HTML"
## What it does
Converts natural language UI descriptions into structured wireframes in two output formats: machine-readable `.wireframe.json` for programmatic use and a single-file interactive HTML preview with drag-and-drop element reordering, copy/paste, delete and undo/redo history. Can also read a `designs/{design-id}/output/design-spec.md` file from an external design workflow and extract its layout. Requires Python 3 and a modern browser. Ideal for rapid lo-fi ideation before any visual design work begins.
## When NOT to use
- High-fidelity mockups with color and typography — use wireframer instead
- Excalidraw-format output — use excalidraw-diagram instead
- When 5 parallel UX variants are needed — use claude-wireframe-skill instead; it installs a skill with the same `wireframe` directory name, so choose one of the two
© podo · MIT · podo/design-agent-skills