design-principles

Apply named aesthetic philosophies to frontend UI builds and critiques.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/hschne/pi-stuff --skill design-principles-hschne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-principles
Source: https://github.com/hschne/pi-stuff/tree/main/skills/design-principles
Command: npx skills add https://github.com/hschne/pi-stuff --skill design-principles-hschne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the common issue of generic, indistinguishable AI-generated frontend interfaces by guiding users to apply intentional, named aesthetic philosophies for unique, production-grade UI builds and critiques.

Core Features & Use Cases

  • Aesthetic Philosophy Guidance: Includes 8 distinct, implementation-ready aesthetic frameworks (Dieter Rams, Swiss Typographic, Japanese Minimalism, Brutalist, Scandinavian, Art Deco, Neo-Memphis, Editorial) with specific rules for typography, color, layout, motion, and detail treatment.
  • Codebase Alignment Checks: Directs users to scan existing projects for components, design tokens, UI framework configs, and font assets to avoid duplication and ensure consistency with existing design systems.
  • Compliant Implementation Rules: Enforces mobile-first responsive design, accessible dark mode support, and reduced motion preferences for all outputs, regardless of chosen aesthetic.
  • Use Case: A frontend developer building a settings page for a Scandinavian lifestyle app can use this Skill to select the matching aesthetic, align with existing brand tokens, and implement a warm, accessible interface that avoids generic AI design patterns.

Quick Start

Use the design-principles skill to build a hero section for a Japanese minimalist e-commerce product page, following the Ma aesthetic philosophy guidelines for typography, spacing, and motion.

Frequently Asked Questions about design-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I avoid generic AI aesthetics when building frontend UI components?

To avoid generic AI aesthetics in frontend UI components, apply named aesthetic philosophies like Swiss Typographic or Japanese Minimalism to enforce specific rules for typography, color, and layout. This ensures distinctive, production-grade interface builds.

Can I use Tailwind CSS and shadcn/ui to apply specific frontend design philosophies?

Yes, you can apply aesthetic philosophies using Tailwind CSS and shadcn/ui by aligning the chosen design framework with your existing codebase design tokens. This approach enforces mobile-first responsive design and accessible dark mode support.

What aesthetic philosophies can I apply for interface critique workflows?

Interface critique workflows can apply eight implementation-ready aesthetic philosophies, including Dieter Rams, Brutalist, Scandinavian, and Neo-Memphis. Each provides specific rules for typography, color, layout, motion, and detail treatment.

How do I align new page layout designs with my existing design tokens?

Align new page layout designs with existing design tokens by scanning your project for current UI components, framework configurations, and font assets. This prevents duplication and ensures brand consistency across your frontend design system.

Does applying an aesthetic philosophy ensure accessible dark mode and mobile-first responsive design?

Yes, applying an aesthetic philosophy enforces compliant implementation rules including mobile-first responsive design, accessible dark mode support, and reduced motion preferences for all frontend outputs, regardless of the chosen visual style.

What is the best way to build a Japanese minimalist e-commerce frontend interface?

The best way to build a Japanese minimalist e-commerce frontend interface is to select the matching Ma aesthetic philosophy guidelines, applying its specific rules for typography, spacing, and motion to achieve a distinct, intentional design.