Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill generic-static-ux-designer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/generic-static-ux-designer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/generic-static-ux-designer/

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

Similar skills

All skills for Design →

From the same set117

The whole set →
microservices-architecture The microservices-architecture Claude Code skill guides microservice design, monolith decomposition, and service communication choices. It activates for distributed-system design tasks. CX Codex +1 153installs debug-systematic debug-systematic — a four-phase debugging skill for hard-to-reproduce failures, race conditions, and unexplained behavior. It guides the agent from reproduction to verified fix. CX Codex +1 152installs mobile-cicd mobile-cicd guides CI/CD pipelines for iOS and Android apps using Fastlane, GitHub Actions, EAS Build, and code signing configs. CX Codex +1 152installs ai-policy-generator The ai-policy-generator skill helps draft organizational AI policies, classify use-case risk, and define rules for data, oversight, ethics, and compliance. CX Codex +1 152installs pwa-development The pwa-development Claude Code skill guides work on installable web apps with offline support. It activates for PWA builds, service worker setup, and offline-first features. CX Codex +1 150installs sales sales guides B2B deal qualification, revenue forecasting, and pipeline reviews inside your coding agent. CX Codex +1 150installs onboarding-guide-creator onboarding-guide-creator builds role-specific onboarding plans with timelines, tasks, and milestones. Use it to draft a new hire welcome guide or training program. CX Codex +1 150installs customer-persona-builder customer-persona-builder builds ICPs, buyer personas and user archetypes from templates, with a weighted scoring matrix and interview questions behind them. CX Codex +1 149installs

Project sponsors

Companies that keep this analytics open