CommunityCoding & Developmentgithub.com

premium-frontend

Art-director judgement for premium local-business websites — typography, spacing, composition, photography, hierarchy, restraint. Use when designing or restyling a page or section, when asked to make something "more beautiful", "more premium" or "less AI-looking", and when reviewing visual quality before shipping. For conversion review use conversion-optimization; for screenshot QA use visual-qa.

What is premium-frontend?

premium-frontend is a Claude Code agent skill that art-director judgement for premium local-business websites — typography, spacing, composition, photography, hierarchy, restraint. Use when designing or restyling a page or section, when asked to make something "more beautiful", "more premium" or "less AI-looking", and when reviewing visual quality before shipping. For conversion review use conversion-optimization; for screenshot QA use visual-qa.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/artem2167/website-factory/tree/HEAD/.claude/skills/premium-frontend

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does premium-frontend do?

The art direction standard for this factory. This skill exists so that "make it beautiful" never has to be a prompt again.

Core

Premium websites rely on:
- typography
- spacing
- composition
- photography
- hierarchy
- restraint

Never improve a design by blindly adding:
- gradients
- cards
- shadows
- glassmorphism
- animations

When reviewing a page, evaluate:
1. hierarchy
2. typography
3. whitespace
4. composition
5. image crops
6. alignment
7. visual rhythm
8. consistency
9. responsiveness
10. perceived brand quality

What "make it more beautiful" means here

Do not add decoration. Change composition.

SymptomWrong fixRight fix
Section feels flatadd a gradient or shadowraise type-scale contrast, widen whitespace, break the grid
Page feels cheapadd glassmorphismreplace stock-looking images, fix the crops
Section feels emptyadd a card gridmake the image bigger, the heading larger, the text column narrower
Nothing draws the eyeadd an accent colorestablish one dominant element per screen
Feels genericadd micro-animationsmove from centered to asymmetric composition

Banned defaults

These are the fingerprints of an AI-generated site. Do not ship them:

  • purple/indigo gradients anywhere;
  • every fact wrapped in a rounded card with an icon on top;
  • three equal feature columns with a Lucide icon in each;
  • pill badges above every heading;
  • floating blurred blobs;
  • glassmorphism panels;
  • drop shadows on everything;
  • the whole page centered.

Typography

  • one display font plus one body font, no more;
  • define a real scale and stay on it — do not invent a size per section;
  • headlines genuinely large on desktop, genuinely readable on mobile;
  • body copy at 60–75 characters per line;
  • tighten tracking as size increases, never the reverse;
  • vertical defaults: hotel and beauty use an editorial serif display; restaurant uses an expressive display; dental and medical use a clean sans with serif only as a restrained accent.

Spacing

  • section padding is a design decision, not a constant;
  • important sections get more room than supporting sections;
  • mobile spacing is designed, not a scaled-down desktop;
  • inner spacing must always be clearly smaller than outer spacing — if a section's internal gaps rival its outer padding, the hierarchy is broken.

Photography

  • the photo is the composition, not an illustration placed next to text;
  • one large image beats four small ones;
  • vary image sizes down the page — identical thumbnails read as a template;
  • respect the subject's safe area: faces, plated food and room interiors each crop differently;
  • never letterbox or squash; choose an aspect ratio and crop to it;
  • always route through the Next.js image pipeline and reserve the space to prevent layout shift.

Color

  • a premium palette is mostly neutral with one committed accent;
  • "premium" is not gold plus black;
  • contrast comes from value, not from saturation;
  • the accent belongs on the primary CTA before it goes anywhere else.

Animation

  • one shared vocabulary for the whole factory: durations, easings, stagger, reveal threshold;
  • reveal on scroll, subtle translate, restrained image scale on hover;
  • never delay access to content, never animate every element;
  • honour prefers-reduced-motion.

Before declaring a section done

Ask: if the decoration were removed entirely, would the composition still hold?

If not, the decoration was carrying the design. Fix the composition instead.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Related Skills