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
npx skills add travisjneuman/.claude --skill frontend-enhancer -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/frontend-enhancer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/frontend-enhancer/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill frontend-enhancer -a codex2Manually: put the files in place
.agents/skills/frontend-enhancer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill frontend-enhancer -a cursor2Manually: put the files in place
.cursor/skills/frontend-enhancer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install travisjneuman/.claude skills/frontend-enhancer2Manually: put the files in place
.github/skills/frontend-enhancer/SKILL.md1Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill frontend-enhancer -a gemini-cli2Platform CLI
gemini skills install https://github.com/travisjneuman/.claude --path skills/frontend-enhancerManually: put the files in place
.devin/skills/frontend-enhancer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add travisjneuman/.claude --skill frontend-enhancer -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 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.