designing-frontend-interfaces

Installation
SKILL.md

Designing Frontend Interfaces

Overview

Distinctive interfaces come from committing to one aesthetic direction and executing it with a locked system of values. Generic interfaces come from picking each value ad hoc at the moment it is needed.

Core principle: Decide the system before you write the components. Every number in the finished CSS should trace back to a scale you chose deliberately.

First decision: what kind of interface is this?

  • Marketing surfaces — landing pages, docs, brand sites, portfolios. Here you art-direct: named aesthetic direction, memorable moment, expressive type.
  • App surfaces — dashboards, admin panels, settings, data tools. Here the user's expectations are set by every professional tool they already use (Jakob's Law). The design is the conventions: canvas/surface layering, fixed density scales, a 14px data grid. Art-directing a data tool the way you would a landing page is how "amateur" happens.

The token block, hierarchy rules, and component-state rules apply to both. The aesthetic-direction machinery applies to marketing; references/app-styles.md replaces it for apps.

This skill covers visual craft. Two companion skills cover the rest of interface quality:

Installs
791
GitHub Stars
18
First Seen
May 31, 2026