
frontend-design
Build good-looking web interfaces. Use when: - User asks you to build a web app, website, landing page, or HTML page - User asks for a one-off tool, utility, or demo app - User is starting a new frontend project - User wants to improve how something looks - User mentions UI, design, styling, or making something look better This applies to ANY frontend work, not just "design" tasks. Even simple apps benefit from basic design principles.
- Installs
- 165
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/factory-ai/factory-plugins --skill frontend-design- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads frontend-design automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Frontend design
Practical tactics for designing and building frontend interfaces. This is about making things look good and work well, not about frameworks or tooling.
Start with the creative vision
Before touching code, understand what you're trying to achieve emotionally and aesthetically.
Tone
What feeling should this interface convey? Professional and trustworthy? Playful and fun? Calm and minimal? Energetic and bold?
The tone affects every decision: colors, typography, spacing, imagery, micro-interactions.
If there's an existing design language, follow it first. Match the existing tone before introducing new elements. Consistency matters more than novelty.
Aesthetics
Look at references. What interfaces do you admire that have a similar purpose? What makes them work?
Collect screenshots, note what you like about each. Is it the generous whitespace? The bold typography? The subtle shadows? The color palette?
Don't copy directly, but understand the principles behind what you're drawn to.
Then add constraints
Constraints make design easier, not harder. They eliminate decision fatigue.
Spacing scale
Pick a base unit (4px or 8px) and stick to multiples of it.
4, 8, 12, 16, 24, 32, 48, 64, 96, 128
Every margin, padding, and gap should come from this scale. No magic numbers like 13px or 47px.
Type scale
Pick a ratio (1.25 or 1.333 are common) and generate your sizes:
12, 14, 16, 20, 24, 32, 40, 48
Each size has a purpose: body text, subheadings, headings, display text.
Color palette
Start minimal:
- One primary color (your brand or accent)
- Neutrals: white, black, and 3-4 grays
- One semantic color for errors (red)
- One for success (green)
You can always add more later. Starting with fewer colors forces you to use them intentionally.
Layout grid
Use a 12-column grid with consistent gutters. Most layouts can be built with 12 columns.
Design in the browser
Designing directly in code (HTML/CSS) has advantages:
- You see real rendering, real responsiveness
- Faster iteration than design tools for some changes
- No handoff problems
- Version control
Start with mobile, then scale up. It's easier to add space than to remove it.
Common patterns
Cards
Cards group related content. Keep them simple:
- Consistent padding (16px or 24px)
- Subtle border or shadow to separate from background
- Clear hierarchy: image, title, description, action
Forms
- Labels above inputs, not beside
- One column for most forms
- Clear error states (red border, error message below)
- Generous touch targets (44px minimum height on mobile)
Navigation
- Keep primary nav minimal (5-7 items max)
- Current page should be obvious
- Mobile: hamburger menu or bottom nav
- Breadcrumbs for deep hierarchies
Empty states
Don't leave empty areas blank. Show:
- What would normally be here
- How to add content
- An illustration if appropriate
Loading states
- Skeleton screens over spinners when possible
- Show progress for long operations
- Don't block the whole UI if only part is loading
Avoiding AI-slop aesthetics
Generated designs often look generic. To avoid this:
Be specific about what you want. "A modern dashboard" gives you something forgettable. "A dashboard with a dark theme, data visualizations using a blue-to-purple gradient, compact information density, inspired by trading terminals" gives you something distinctive.
Add constraints. Limit your color palette. Commit to a specific type scale. Use a consistent spacing system. Constraints create cohesion.
Look at real references. Find interfaces you admire. Understand why they work. Borrow principles, not pixels.
Edit ruthlessly. Generated designs often have too much going on. Remove decorative elements that don't serve a purpose. Simplify until it feels too simple, then add back one thing.
Test with real content. Lorem ipsum hides problems. Use realistic text lengths, real images, actual data.
Responsive design
Design for mobile first, then add complexity for larger screens.
Breakpoints (common):
- Mobile: up to 640px
- Tablet: 641px to 1024px
- Desktop: 1025px and up
What changes between breakpoints:
- Number of columns
- Font sizes (slightly larger on desktop)
- Navigation pattern
- Amount of content visible
What stays the same:
- Color palette
- Typography hierarchy
- Brand elements
- Core functionality
Accessibility basics
- Color contrast: 4.5:1 minimum for text
- Focus states: visible focus rings for keyboard navigation
- Alt text: describe images meaningfully
- Semantic HTML: use headings, lists, buttons correctly
- Touch targets: 44x44px minimum
These aren't nice-to-haves. They're requirements for usable interfaces.
Quick checklist
Before shipping:
- Consistent spacing from the scale
- Typography hierarchy is clear
- Colors meet contrast requirements
- Works on mobile
- Focus states are visible
- Loading and error states exist
- Empty states are handled
- Real content has been tested
FAQ
What does the frontend-design skill do?
Build good-looking web interfaces. Use when: - User asks you to build a web app, website, landing page, or HTML page - User asks for a one-off tool, utility, or demo app - User is starting a new frontend project - User wants to improve how something looks - User mentions UI, design, styling, or making something look better This applies to ANY frontend work, not just "design" tasks. Even simple apps benefit from basic design principles.
How do I install frontend-design?
Run npx skills add https://github.com/factory-ai/factory-plugins --skill frontend-design in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/frontend-design/ (personal) or .claude/skills/frontend-design/ (project).
Which AI agents can use frontend-design?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is frontend-design safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains frontend-design?
It is published by factory-ai in factory-ai/factory-plugins, and it is an official skill from the maker of the technology it covers. It has 165 recorded installs.
More from factory-ai/factory-plugins
no-use-effect
factory-ai/factory-plugins
Enforce the no-useEffect rule when writing or reviewing React code. ACTIVATE when writing React components, refactoring existing useEffect calls, reviewing PRs with useEffect, or when an agent adds useEffect "just in case." Provides the five replacement patterns and the useMountEffect escape hatch.
human-writing
factory-ai/factory-plugins
Remove signs of AI-generated writing from text to make it sound more natural and human-written. Use when editing or reviewing any form of document including: markdown, technical docs, emails, blog posts, PRDs, or any dedicated writing content. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
simplify
factory-ai/factory-plugins
Review changed code for reuse, quality, and efficiency, then fix any issues found.
visual-design
factory-ai/factory-plugins
Image generation and presentations. Use when: - User asks for images: logos, icons, app assets, diagrams, flowcharts, architecture diagrams, patterns, textures, photo edits, restorations - User needs a presentation or slide deck Covers nanobanana CLI for image generation and Slidev for presentations.
security-review
factory-ai/factory-plugins
Scan code changes for security vulnerabilities using STRIDE threat modeling, validate findings for exploitability, and output structured results for downstream patch generation. Supports PR review, scheduled scans, and full repository audits.
ban-type-assertions
factory-ai/factory-plugins
Ban as type assertions in a package via the @typescript-eslint/consistent-type-assertions lint rule, replacing them with compiler-verified type-safe alternatives. Use when enabling the assertion ban in a new package or fixing violations in an existing one.
Popular frontend & design skills
setup-matt-pocock-skills
mattpocock/skills
Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
frontend-design
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
hyperframes-animation
heygen-com/hyperframes
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.
prototype
mattpocock/skills
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
hyperframes-core
heygen-com/hyperframes
The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.
vercel-react-best-practices
vercel-labs/agent-skills
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.