Skip to main content
skill CX Codex

frontend-enhancer · travisjneuman — Claude Code skill: what it does, how to install

frontend-enhancer polishes the visual side of a web app: palette, layout, motion, component states. Useful when the UI still reads as a stock starter.

MIT 145 installs ★ 114 updated 2026-10-25

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

What frontend-enhancer does

The skill runs styling work in a fixed order: research, audit of what exists, direction, theme tokens, implementation, a pass against generic AI patterns, responsive and accessibility checks, review. For a brand-new look it sends you to ui-research first. Skip that and the result slides back toward framework defaults, which is exactly what it wants you to avoid.

What the agent actually applies is reference material: named palettes with a full token set, button, card and form patterns with variants and states, motion limited to transform and opacity with timings from 100 to 500ms, breakpoints up to 1280px, and an accessibility checklist covering 4.5:1 contrast, keyboard focus, 44x44px touch targets and prefers-reduced-motion.

The cn helper it writes into lib/utils.ts imports clsx and tailwind-merge, so both packages have to be in the project already or the snippet won't compile. Its list of AI-looking tells, from default blue-purple gradients to glassmorphism, is something the agent reads through, not a linter.

What it helps with

  • pick a brand palette and map it onto theme tokens
  • build a layout that holds up from phone to desktop
  • add hover motion without dropping frames
  • strip default gradients and stock art from a page
  • check contrast and tap targets before shipping

Example prompts for the agent

  • Make this dashboard look designed: custom palette, off-grid layout, real button states.
  • Add hover animations to the cards and make sure they stop under prefers-reduced-motion.
  • Run the accessibility checklist on the settings screen and list what to fix.

How to install frontend-enhancer

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill frontend-enhancer -a claude-code

2Manually: put the files in place

~/.claude/skills/frontend-enhancer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/frontend-enhancer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about frontend-enhancer

How do I install frontend-enhancer in Claude Code?

Run npx skills add travisjneuman/.claude --skill frontend-enhancer -a claude-code. The skill file lands at ~/.claude/skills/frontend-enhancer/SKILL.md.

What does frontend-enhancer do?

It guides visual work on a web app: palette and theme tokens, component patterns, motion rules, breakpoints and an accessibility pass. It starts by auditing the current interface against reference products.

Do I need ui-research as well?

For a new design direction, yes — the skill defers to ui-research so choices come from real products. When you're only tightening an existing style, go straight to frontend-enhancer.

Source text

SKILL.md · MIT
---
name: frontend-enhancer
description: "Enhance the visual design of web apps: modern UI components, layout, responsive design, color palettes, animations. Use for styling and UI polish; pair with ui-research first for new design directions."
---

# Frontend Enhancer

Transform web applications into visually polished, human-designed experiences.

## Prerequisite: Research First

For a new design direction, run `ui-research` first so choices come from real reference products rather than default styles; the specific defaults to avoid are under "Avoiding the AI Look". See [UI Inspiration Sources](../_shared/UI_INSPIRATION_SOURCES.md).

---

## When to Use

**Use for:**

- Improving styling and visual design
- Creating responsive layouts
- Adding animations and transitions
- Selecting color schemes
- Building modern UI patterns
- Enhancing aesthetics

**Don't use when:**

- Need inspiration first → use `ui-research` first
- UX flow design → use `generic-ux-designer`
- Code architecture → use `generic-feature-developer`
- Code review → use `generic-code-reviewer`

**Foundational References:**

- [UI Inspiration Sources](../_shared/UI_INSPIRATION_SOURCES.md) - Research sources
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Visual tokens

## Research-Driven Enhancement Workflow

1. **Research** - Use `ui-research` skill first (5-10 examples minimum)
2. **Assess** - Identify current gaps against research findings
3. **Plan** - Define direction based on inspiration analysis
4. **Foundation** - Set up colors, spacing, animations in theme
5. **Apply** - Implement with human polish (not defaults)
6. **Anti-AI Check** - Verify no generic AI patterns
7. **Refine** - Test responsiveness, verify accessibility
8. **Review** - Check hierarchy, consistency, performance

## Color Palette Selection

| Palette         | Use Case                    |
| --------------- | --------------------------- |
| Corporate Blue  | Business apps, SaaS         |
| Vibrant Purple  | Creative tools, portfolios  |
| Minimalist Gray | Clean, sophisticated        |
| Warm Sunset     | Consumer apps, e-commerce   |
| Ocean Fresh     | Health, finance apps        |
| Dark Mode       | Developer tools, dashboards |

Each palette needs: Primary, Secondary, Accent, Background, Foreground, Muted, Success, Warning, Error

## Component Patterns

### Buttons

- Variants: primary, secondary, outline, ghost, danger
- Sizes: sm, md, lg
- States: loading, disabled

### Cards

- Variants: default, bordered, elevated, interactive
- Subcomponents: Header, Title, Description, Content, Footer

### Forms

- Clear focus states
- Validation feedback
- Helper text
- Required indicators

## Animation Guidelines

**GPU-Accelerated Only:**

```css
/* ✅ DO animate */
transform: translateY(-4px);
opacity: 0.8;

/* ❌ AVOID */
margin-top: -4px;
height: 100px;
```

**Duration Guidelines:**

- Micro-interactions: 100-200ms
- Transitions: 200-300ms
- Complex animations: 300-500ms

**Accessibility:**

```css
@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}
```

## Responsive Strategy

| Breakpoint | Min Width | Target       |
| ---------- | --------- | ------------ |
| base       | 0         | Mobile       |
| sm         | 640px     | Large phones |
| md         | 768px     | Tablets      |
| lg         | 1024px    | Laptops      |
| xl         | 1280px    | Desktops     |

## Accessibility Checklist

- [ ] Color contrast >= 4.5:1 (WCAG AA)
- [ ] Keyboard accessible
- [ ] Visible focus indicators
- [ ] Semantic HTML
- [ ] Alt text on images
- [ ] Form labels
- [ ] Respects prefers-reduced-motion
- [ ] Touch targets >= 44x44px

## Layout Patterns

### Hero Section

- Centered, split, or minimal variants
- Primary + secondary CTAs
- Optional background gradients

### Feature Grid

- 2, 3, or 4 columns
- Icon + title + description
- Staggered animations
- Hover effects

## Performance

- Bundle size awareness
- Lazy load heavy components
- Optimize images (WebP, responsive)
- 60fps animations

## cn Utility Setup

```typescript
// lib/utils.ts
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";

export function cn(...inputs: ClassValue[]) {
  return twMerge(clsx(inputs));
}
```

## Before/After Pattern

When enhancing, document changes:

```
Before: Plain gray button, no hover state
After: Gradient primary button with hover lift effect
```

## Avoiding the AI Look

### Red Flags to Check

Before finalizing, ensure you DON'T have:

- [ ] Default blue/purple gradients
- [ ] Perfectly symmetrical layouts
- [ ] Generic blob/wave decorations
- [ ] Undraw-style stock illustrations
- [ ] "Hero with laptop mockup" cliché
- [ ] Unchanged default color schemes
- [ ] Cookie-cutter card grids
- [ ] Overused glassmorphism/blur

### Human Touch Checklist

Ensure you DO have:

- [ ] Custom color palette (not defaults)
- [ ] Intentional layout asymmetry
- [ ] Unique typography pairing
- [ ] Real/custom imagery
- [ ] Micro-interactions with personality
- [ ] Brand-specific details
- [ ] Thoughtful empty/loading states
- [ ] Copy with character

### Quality Comparison

| Aspect      | Generic AI    | Human-Polished         |
| ----------- | ------------- | ---------------------- |
| **Color**   | Default blue  | Custom brand palette   |
| **Layout**  | Perfect grid  | Intentional variation  |
| **Images**  | Stock/generic | Curated/custom         |
| **Copy**    | Lorem ipsum   | Real, personality-rich |
| **Motion**  | Basic fades   | Purposeful, branded    |
| **Details** | None          | Hover states, feedback |

---

## See Also

- [UI Inspiration Sources](../_shared/UI_INSPIRATION_SOURCES.md) - Research sources (USE FIRST)
- [Design Patterns](../_shared/DESIGN_PATTERNS.md) - Visual design reference
- [UX Principles](../_shared/UX_PRINCIPLES.md) - User experience
- `ui-research` - Research step to run first for new design directions
- Project `CLAUDE.md` - Design constraints

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Frontend and UI →

frontend-enhancer by other authors comes first.

frontend-enhancer ailabs-393 frontend-enhancer — a Next.js skill with ready React components, six color palettes, CSS animations and section templates. Useful when the interface needs a visual pass. CX Codex +1 978installs frontend-design jdrhyne frontend-design — a skill that sets the order of UI work: wireframe, theme, animation, then code. Useful for landing pages, dashboards and single components. CX Codex +1 ★ 239repo stars frontend-tailwind-best-practices sergiodxa frontend-tailwind-best-practices is a Claude Code skill with 10 Tailwind CSS rules for component styling, covering stack utilities, gap spacing, dark color schemes, and className merging. CX Codex +1 470installs designing-frontend-interfaces osmontero The designing-frontend-interfaces skill makes the agent write a design brief and lock a token block before touching component code. Useful when your UI looks like default AI output. CX Codex +1 783installs tailwind-ui-refactor pproenca tailwind-ui-refactor — a skill that refactors HTML with Tailwind utility classes: hierarchy, spacing, typography, color. Useful when you build UI without a designer on hand. CX Codex +1 474installs media-publishing dylantarre media-publishing guides UI motion design for news websites, digital magazines, and reader apps based on Disney's 12 animation principles. CX Codex +1 548installs Frontend Responsive Design Standards am-will Frontend Responsive Design Standards — a skill that gives your coding agent rules for mobile-first layouts: breakpoints, relative units, touch targets and content priority. CX Codex +1 1,200installs

From the same set117

The whole set →
generic-code-reviewer generic-code-reviewer inspects code diffs for security risks, runtime errors, bundle bloat, and WCAG AA gaps. It adapts checks to your project stack and enforces workflow rules from CLAUDE.md. CX Codex +1 147installs monitoring-observability monitoring-observability equips AI coding agents to set up OpenTelemetry, structured JSON logging, and distributed tracing. Useful when defining SLO alerts or instrumenting services. CX Codex +1 146installs codebase-documenter codebase-documenter turns a repository into readable docs: README, architecture overview, onboarding guide, API reference and code comments. Handy when someone new has to understand the project. CX Codex +1 145installs impact-report-writer The impact-report-writer skill helps structure program impact reports, choose outcome metrics, and plan data visualizations. Use it for annual reports or program evaluations. CX Codex +1 145installs status-report-generator The status-report-generator Claude Code skill builds project status reports from Git activity, task context, and milestone tracking. It can create weekly updates, sprint reviews, and stakeholder reports. CX Codex +1 145installs generic-ux-designer generic-ux-designer — a UX skill for Claude and other coding agents: design-thinking steps, heuristic review and accessibility checks, packaged as checklists the agent follows. CX Codex +1 145installs performance-engineering performance-engineering — a skill for Claude Code designed for full-stack web application performance optimization. Activates when Core Web Vitals drop, bundle sizes increase, or page response times degrade. CX Codex +1 144installs authentication-patterns authentication-patterns — a Claude Code skill for authentication and authorization patterns. It comes into play when building login flows, MFA, SSO, or access-control models. CX Codex +1 144installs

Project sponsors

Companies that keep this analytics open