# ui-craft

ui-craft — a skill for designing and building visible interfaces: pages, components, forms, loading and error states, AI chat surfaces with streaming. Works within your project's design system and validates accessibility.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 314 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/ui-craft/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pedro-nauck-ui-craft

## What it does

ui-craft orients an agent toward working with actual code and your project's design contract. The skill teaches reading color tokens, spacing, and type; finding existing primitives instead of reinventing them; and checking keyboard navigation and color contrast. Backend, infrastructure, CLI, and docs-only work are out of scope.

The skill includes reference guides for accessibility (WCAG 2.2 AA), component patterns, microcopy, and AI interfaces, plus helper scripts to validate contrast and token drift. For substantial design changes, the skill may ask for a short user goal or visual decisions, but does not require artifacts for every edit.

Install once across six platforms using `npx skills add` or `gh skill install`. The skill lives in your project folder and can be committed to version control.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ui-craft -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ui-craft/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ui-craft/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ui-craft -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ui-craft/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ui-craft -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ui-craft/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/ui-craft
```

2. **Manually: put the files in place**
- File: `.github/skills/ui-craft/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ui-craft -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/ui-craft
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ui-craft/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill ui-craft -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/ui-craft/SKILL.md

## When to use it
- build UI components using design tokens and existing patterns
- audit accessibility: keyboard navigation, contrast ratios, semantic markup
- refactor interfaces without breaking focus, state, or supported interactions
- detect and fix AI-generated UI mistakes (14 common patterns)
- design streaming chat surfaces with citations and confidence signals

## Example prompts
- Refactor this form so field labels match the design system, then check contrast on dark backgrounds
- Add an error state for this input using the primitives from `references/component-patterns.md`
- Build a streaming response interface for an AI agent with progress feedback and quote attribution

## Similar
- [critique-color](https://affpapa.org/en/nevibecode/skills/critique-color.md) — skill · 2100 installs
- [accessibility-compliance](https://affpapa.org/en/nevibecode/skills/accessibility-compliance.md) — skill · 14596 installs
- [visual-design-foundations](https://affpapa.org/en/nevibecode/skills/visual-design-foundations.md) — skill · 13566 installs
- [UI Craft](https://affpapa.org/en/nevibecode/mcp/ui-craft.md) — MCP server · ★ 469 repo stars
- [color-accessibility](https://affpapa.org/en/nevibecode/skills/color-accessibility.md) — skill · 628 installs
- [ui-designer](https://affpapa.org/en/nevibecode/agents/voltagent-community-ui-designer.md) — subagent · 1979 installs

## Other versions with the same name
- [ui-craft · educlopez](https://affpapa.org/en/nevibecode/skills/ui-craft.md) — 1700 installs

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
