ux-ui-design
An end-to-end design tool for creating wireframes, flows, and HTML/CSS prototypes.
Install
mkdir -p .claude/skills/ux-ui-design && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10181" && unzip -o skill.zip -d .claude/skills/ux-ui-design && rm skill.zipInstalls to .claude/skills/ux-ui-design
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Design user experiences with wireframing, prototyping, user flows, accessibility, and production-ready HTML prototypes. Use when creating wireframes, building interactive prototypes, designing user flows, implementing accessibility standards, or producing HTML/CSS design deliverables.Key capabilities
- →Design user flows and information architecture
- →Create wireframes and high-fidelity mockups
- →Build interactive HTML/CSS prototypes
- →Perform accessibility (WCAG) audits
- →Define design systems and token sets
How it works
It follows a structured design process from research and IA to prototyping, enforcing accessibility and design system standards throughout.
Inputs & outputs
When to use ux-ui-design
- →Design a new user flow
- →Create a high-fidelity prototype
- →Perform an accessibility audit
- →Build a production-ready HTML interface
About this skill
UX/UI Design & Prototyping
Purpose: Create user-centered designs, wireframes, prototypes, and production-ready HTML/CSS interfaces.
When to Use This Skill
- Creating wireframes or high-fidelity mockups
- Building interactive HTML/CSS prototypes
- Designing user flows and information architecture
- Implementing accessibility (WCAG) standards
- Setting up design systems or component libraries
Prerequisites
- Basic HTML/CSS knowledge for prototyping
- Design tool access
Decision Tree
Use this to pick the right UX approach for your task:
Start: What is the deliverable?
|
+- New feature / epic?
| - 1. User Research -> 2. IA -> 3. Wireframes -> 4. User Flows
| -> 5. Hi-Fi Mockups -> 6. HTML Prototype -> 7. Usability Test
|
+- Bug fix / small change?
| - Skip to step 5 (Hi-Fi) or 6 (HTML Prototype)
|
+- Design system update?
| - Jump to Design Systems - update tokens + components
|
+- Accessibility audit?
| - Jump to Accessibility - run checklist + fix
|
- Responsive issue?
- Jump to Responsive Design - breakpoint check + fix
Table of Contents
- User Research & Analysis
- Information Architecture
- Wireframing
- User Flows
- High-Fidelity Mockups
- Interactive Prototypes
- HTML/CSS Prototypes
- Design Systems
- Accessibility (A11y)
- Responsive Design
- Usability Testing
- Best Practices
- Tools & Resources
Core Rules
[PASS] DO
Research & Wireframing:
- Define Product Posture & Archetype BEFORE sketching any screens
- Start with lo-fi sketches; iterate on paper first
- Use real content, never lorem ipsum in final designs
- Annotate interactions on every wireframe
- Test with diverse user demographics
Design & Prototyping:
- Follow the 8px spacing grid
- Design for ALL states: empty, loading, error, success, partial
- Build production-ready HTML/CSS prototypes (mandatory)
- Use semantic HTML5 + ARIA attributes from the start
- Use CSS custom properties for all design tokens (see
prototype-craftasset) - Validate HTML & CSS
Collaboration:
- Document every design decision
- Share prototypes early and gather developer feedback
- Version-control design files
- Hand off with detailed specifications
[FAIL] DON'T
- Skip user research or design in isolation
- Leave placeholder content in final deliverables
- Ignore edge cases and error states
- Forget mobile/tablet breakpoints
- Neglect accessibility until the end
- Hardcode values instead of using design tokens
- Use large unoptimized images
- Inline all styles (use external stylesheets)
- Block rendering with synchronous scripts
Anti-Patterns
- Skipping user research: Designing based on assumptions -> conduct interviews or surveys with 5+ users before wireframing
- Lorem ipsum in deliverables: Placeholder text hides content layout problems -> use realistic content from the actual domain
- Desktop-first design: Retrofitting mobile after desktop -> design mobile breakpoints first, then enhance upward
- Ignoring error states: Only designing the happy path -> design empty, loading, error, partial, and success states for every screen
- Pixel-perfect handoff without tokens: Hardcoded colors and sizes -> define a design token system (CSS custom properties) and reference tokens in specs
- Accessibility as afterthought: Running audits only at the end -> integrate WCAG checks from wireframe stage, not after prototyping
- Overly complex user flows: 10+ step flows without progress indicators -> limit critical paths to 3-5 steps with clear progress feedback
- No version control on designs: Overwriting files with no history -> use Git for HTML prototypes and Figma version history for mockups
Tools & Resources
Design & Wireframing
| Tool | Use Case | Link |
|---|---|---|
| Figma | Collaborative design | figma.com |
| Sketch | Mac design | sketch.com |
| Penpot | Open-source design | penpot.app |
| Balsamiq | Quick wireframes | balsamiq.com |
| Whimsical | Flowcharts + wireframes | whimsical.com |
| Excalidraw | Hand-drawn diagrams | excalidraw.com |
Prototyping
| Tool | Use Case | Link |
|---|---|---|
| CodePen | Quick HTML/CSS/JS | codepen.io |
| Tailwind CSS | Utility-first CSS | tailwindcss.com |
| Bootstrap | Component framework | getbootstrap.com |
Accessibility
| Tool | Use Case | Link |
|---|---|---|
| WAVE | Accessibility checker | wave.webaim.org |
| axe DevTools | Browser extension | deque.com/axe |
| WCAG Quick Ref | Guidelines | w3.org/WAI |
Inspiration
Reference Files
Detailed code blocks and templates are extracted into dedicated reference files:
| Reference | Contents |
|---|---|
| html-prototype-code.md | Full HTML/CSS/JS prototype code (dashboard, modals, forms, tokens) |
| research-templates.md | Persona template, user journey map template |
| accessibility-patterns.md | Screen reader markup, keyboard navigation JS, ARIA patterns |
| responsive-patterns.md | Breakpoint CSS, responsive grid, mobile-first examples |
| usability-testing-template.md | Full usability test plan, script, and results template |
Related Skills:
Version: 2.0.0 - Last Updated: February 10, 2026
Troubleshooting
| Issue | Solution |
|---|---|
| Prototype not accessible | Run WAVE or axe-core audit, ensure ARIA labels and keyboard navigation |
| Inconsistent design across pages | Create a design token system with shared colors, spacing, typography |
| User flow too complex | Reduce steps to 3-5 maximum, add progress indicators |
References
- Prototype Tokens Asset - Production-ready CSS variables
- Design System Reasoning - Posture and archetype framework
- Research Ia Wireframing
- Flows Mockups Prototypes
- Design Systems A11y
When not to use it
- →When skipping user research
- →When designing in isolation
- →When ignoring mobile/tablet breakpoints
Prerequisites
Limitations
- →Requires design tool access
- →Cannot replace user research with assumptions
How it compares
It mandates production-ready HTML/CSS prototypes and accessibility integration from the wireframe stage, unlike purely visual design workflows.
Compared to similar skills
ux-ui-design side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| ux-ui-design (this skill) | 0 | 4mo | No flags | Intermediate |
| frontend-design | 0 | 6mo | Review | Intermediate |
| ui-ux-designer | 41 | 4mo | No flags | Intermediate |
| ui | 4 | 1mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by jnPiyush
View all by jnPiyush →You might also like
frontend-design
darthlinuxer
Design thinking and decision-making for web UI. Use when designing components,
ui-ux-designer
sickn33
Create interface designs, wireframes, and design systems. Masters user research, accessibility standards, and modern design tools. Specializes in design tokens, component libraries, and inclusive design. Use PROACTIVELY for design systems, user flows, or interface optimization.
ui
nuxt
Build UIs with @nuxt/ui v4 — 125+ accessible Vue components with Tailwind CSS theming. Use when creating interfaces, customizing themes to match a brand, building forms, or composing layouts like dashboards, docs sites, and chat interfaces.
userinterface-wiki
raphaelsalaja
UI/UX best practices for web interfaces. Use when reviewing animations, CSS, audio, typography, UX patterns, prefetching, or icon implementations. Covers 11 categories from animation principles to typography. Outputs file:line findings.
impeccable
rawkode-academy
Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding,
visual-design-foundations
wshobson
Apply typography, color theory, spacing systems, and iconography principles to create cohesive visual designs. Use when establishing design tokens, building style guides, or improving visual hierarchy and consistency.