Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill wireframe-skill -a claude-code
Open on GitHub

What 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.md into 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-code

2Manually: put the files in place

~/.claude/skills/wireframe-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/wireframe-skill/

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

Similar skills

All skills for Design →

From the same set108

The whole set →
wireframer wireframer turns a written description into a clickable, hand-drawn wireframe of a web page: grey boxes, doodle icons, graph paper. Useful before anyone starts arguing about colors. CX Codex +1 207installs design-for-ai design-for-ai adds a four-stage design workflow to your agent: research, plan, mock, and build. Prevents generic AI aesthetics like dark cyan palettes and uniform cards. CX Codex +1 206installs content-catalogue content-catalogue is a Claude Code skill that finds skills for design and product work, from slide decks and diagrams to UX strategy and interface copy. CX Codex +1 206installs design-with-claude design-with-claude runs a deterministic design-system audit and sends findings to focused slash commands. Use it when an interface needs a structured review before changes. CX Codex +1 206installs swiftui-patterns swiftui-patterns is a Claude Code skill with idiomatic SwiftUI patterns for tab navigation, screen layouts, custom modifiers, and state handling. CX Codex +1 205installs data-analysis-skill The data-analysis-skill skill reviews Excel and CSV data, runs parallel expert analysis, and builds interactive HTML reports with charts. It can export the report to PowerPoint when requested. CX Codex +1 205installs threejs-claude-skill-package threejs-claude-skill-package — a bundle of 24 deterministic Three.js skills for scene building, WebGPU, React Three Fiber, physics, and architectural IFC models. CX Codex +1 205installs nanobanan-ppt nanobanan-ppt reads a document, splits it into slides and draws theme-matched images with Gemini. You get slide images and an HTML player, not a .pptx. CX Codex +1 204installs

Project sponsors

Companies that keep this analytics open