ui-craft · pedronauck — Claude Code skill: UI design and component work
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.
no license 314 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill ui-craft -a claude-codeWhat ui-craft 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.
What it helps with
- 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 for the agent
- 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
How to install ui-craft
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ui-craft -a claude-code2Manually: put the files in place
~/.claude/skills/ui-craft/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ui-craft/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ui-craft -a codex2Manually: put the files in place
.agents/skills/ui-craft/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ui-craft -a cursor2Manually: put the files in place
.cursor/skills/ui-craft/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/ui-craft2Manually: put the files in place
.github/skills/ui-craft/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ui-craft -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/ui-craftManually: put the files in place
.devin/skills/ui-craft/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill ui-craft -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 ui-craft
How do I install ui-craft in Claude Code?
Run npx skills add pedronauck/skills --skill ui-craft -a claude-code, then check ~/.claude/skills/ui-craft/SKILL.md. For other platforms, swap -a to codex, cursor, gemini-cli, or opencode.
What does ui-craft do?
The skill guides you through designing and building visible UI grounded in your project's design system. It checks accessibility (WCAG 2.2), keyboard operation, contrast, and component states. It excludes backend, infrastructure, and CLI work.
Which platforms support ui-craft?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Each platform has its own install command and stores the skill in your project folder.
Similar skills
All skills for Frontend and UI →ui-craft by other authors comes first.