generic-static-ux-designer — Claude Code skill: guide and setup
generic-static-ux-designer is a Claude Code skill for designing static HTML, CSS, and JS interfaces with fast loads, accessibility, minimalist layouts, and no-JS fallbacks.
MIT 151 installs ★ 114 updated 2026-10-25
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a claude-codeWhat generic-static-ux-designer does
This skill instructs the agent to design lightweight static web pages under strict performance budgets. It enforces an 80 to 20 content-to-chrome ratio, a restricted palette of 2–3 colors, and high contrast instead of soft gradients. Target performance thresholds are rigid: page payload under 50KB excluding imagery, sub-second initial load, and interaction latency below 100ms.
The logic relies entirely on progressive enhancement. It favors standard HTML elements like <details> and CSS hover transitions over client-side scripting and SPA frameworks. Touch targets require at least 44x44px with 8px spacing. Any addition of web fonts, heavy graphics, or animation libraries is flagged as a red flag unless strictly necessary.
What it helps with
- Audit static pages against a strict 50KB payload budget
- Replace script-based UI widgets with semantic CSS and HTML equivalents
- Validate accessibility targets including 4.5:1 contrast and 44px tap targets
- Structure multi-page navigation without single-page application patterns
Example prompts for the agent
- Audit this landing page layout against static UX performance rules
- Refactor this interactive accordion to use native HTML without JavaScript
- Check our color scheme and button targets for mobile accessibility
How to install generic-static-ux-designer
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a claude-code2Manually: put the files in place
~/.claude/skills/generic-static-ux-designer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/generic-static-ux-designer/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a codex2Manually: put the files in place
.agents/skills/generic-static-ux-designer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a cursor2Manually: put the files in place
.cursor/skills/generic-static-ux-designer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/generic-static-ux-designer2Manually: put the files in place
.github/skills/generic-static-ux-designer/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/generic-static-ux-designerManually: put the files in place
.devin/skills/generic-static-ux-designer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -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 generic-static-ux-designer
How to install generic-static-ux-designer in Claude Code?
Run npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a claude-code in your terminal.
What does generic-static-ux-designer do?
It guides coding agents to follow minimalist UI/UX practices for static sites, keeping assets tiny and interfaces functional without client-side scripts.
Does this skill work with JavaScript frameworks?
No, it explicitly discourages frameworks and animation libraries, preferring CSS-only interactions and plain HTML.
Source text
SKILL.md · MIT
---
name: generic-static-ux-designer
description: Professional UI/UX design expertise for static HTML/CSS/JS sites. Covers design thinking, user psychology, visual hierarchy, minimalist interaction patterns, accessibility, and performance-driven design. Use when designing features, improving UX, or conducting design reviews.
---
# Static Site UX Designer
Professional UX expertise for minimalist static sites.
**Extends:** [Generic UX Designer](../generic-ux-designer/SKILL.md) - Read base skill for design thinking process, user psychology, heuristic evaluation, and research methods.
## Minimalist Design Philosophy
### Less is More
Every element must earn its place:
- Does this add value for the user?
- Can I remove this and still communicate?
- Is this decoration or function?
### Content-to-Chrome Ratio
Maximize content, minimize interface:
```
BAD: 10% content, 90% navigation/chrome
GOOD: 80% content, 20% essential navigation
```
### Limited Palette = High Impact
- 2-3 colors maximum
- 1 accent color for actions
- Stark contrast over subtle gradients
## Performance-Constrained UX
### Every KB Matters
| Element | Impact |
| -------------------- | ---------- |
| Web font | +50-100KB |
| Hero image | +200-500KB |
| Animation library | +30-50KB |
| JavaScript framework | +30-100KB |
Ask: Does this UX improvement justify the weight?
### Speed is UX
- < 1s load time is expected
- < 100ms interaction response
- Users leave after 3s wait
## Static Page Flow Patterns
### Simple Navigation
```
Home → About → Contact → Back to Home
```
No infinite scroll, no SPA patterns. Clear page boundaries.
### Anchor Navigation
```html
<nav>
<a href="#section1">Section 1</a>
<a href="#section2">Section 2</a>
</nav>
<section id="section1">...</section>
<section id="section2">...</section>
```
## CSS-Only Interaction Patterns
### Accessible Disclosure
```html
<details>
<summary>More info</summary>
<p>Additional content here.</p>
</details>
```
### Hover States
```css
.card {
transition: transform 0.2s ease;
}
.card:hover {
transform: translateY(-2px);
}
```
### No-JavaScript Fallbacks
Always work without JS:
- Navigation works with `<a>` tags
- Forms submit normally
- Content accessible without scripting
## Accessibility in Minimalism
### What Minimalism Allows
| Requirement | Minimalist Solution |
| ---------------- | ------------------------ |
| Focus indicators | Simple outline |
| Skip links | Clean text link |
| Alt text | Concise descriptions |
| Contrast | High contrast by default |
### Touch Targets
- 44x44px minimum
- 8px spacing between targets
- Larger is better on mobile
## Design Critique for Static Sites
### Questions to Ask
1. **Performance impact?**
- How many KB does this add?
- Is it worth the load time?
2. **Works without JS?**
- Core function accessible?
- Progressive enhancement?
3. **Adds clarity or noise?**
- Does this help users?
- Can it be simpler?
4. **Maintains aesthetic?**
- Within color palette?
- Consistent with existing?
### Red Flags
- Adding web fonts without strong reason
- Animation libraries for simple effects
- Complex navigation for few pages
- JavaScript where CSS suffices
## Static UX Checklist
- [ ] Core content visible without scrolling
- [ ] Navigation intuitive (< 5 items)
- [ ] Works without JavaScript
- [ ] Touch targets 44px minimum
- [ ] Color contrast 4.5:1+
- [ ] Page weight < 50KB (excl. images)
## See Also
- [Generic UX Designer](../generic-ux-designer/SKILL.md) - Design thinking, psychology
- [UX Principles](../_shared/UX_PRINCIPLES.md) - Research methods, heuristics
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Visual patterns
© travisjneuman · MIT · travisjneuman/.claude