Skip to main content
skill CX Codex

hugging-face-ui-skills — Claude Code skill for UI design

hugging-face-ui-skills is a Claude Code skill that sets rules for Hugging Face-style interfaces. It applies to dark screens using Inter and a 4px spacing grid.

MIT 266 installs ★ 108 updated 2026-02-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ihlamury/design-skills --skill hugging-face-ui-skills -a claude-code
Open on GitHub

What hugging-face-ui-skills does

The skill defines visual and interaction rules for interfaces styled after Hugging Face. It specifies #0D1119 for page backgrounds, Inter as the primary font, a 4px spacing grid, and a minimum text contrast ratio of 4.5:1. Headings use text-balance at 61px and weight 700; body text uses 15px and weight 500.

It also covers borders, corner radii, focus and hover states, accessible controls, and animation. Destructive or irreversible actions call for an AlertDialog, and focus indicators must remain visible. The input guidance sets field height to 0px, a value to check against the project layout.

What it helps with

  • style a dark interface after Hugging Face
  • apply Inter and a 4px spacing grid
  • set colors, typography, and component radii
  • define focus, hover, and error states

Example prompts for the agent

  • Create a dark Hugging Face-style page using Inter and a 4px spacing grid.
  • Apply the hugging-face-ui-skills rules to the headings and body text.
  • Add focus and hover states following hugging-face-ui-skills.

How to install hugging-face-ui-skills

1Skills CLI (Vercel)

npx skills add ihlamury/design-skills --skill hugging-face-ui-skills -a claude-code

2Manually: put the files in place

~/.claude/skills/hugging-face/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hugging-face/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about hugging-face-ui-skills

How do I install hugging-face-ui-skills in Claude Code?

Run npx skills add ihlamury/design-skills --skill hugging-face-ui-skills -a claude-code. The skill file is located at ~/.claude/skills/hugging-face/SKILL.md.

What does hugging-face-ui-skills do?

It sets design rules for Hugging Face-style interfaces, covering dark surfaces, Inter typography, spacing, components, and interaction states.

What accessibility rules does hugging-face-ui-skills include?

Text must have a contrast ratio of at least 4.5:1, icon-only buttons need an aria-label, and focus indicators must not be removed.

Source text

SKILL.md · MIT
---
name: hugging-face-ui-skills
description: Hugging Face's UI design system. Use when building interfaces inspired by Hugging Face's aesthetic - dark mode, Inter font, 4px grid.
license: MIT
metadata:
  author: design-skills
  version: "1.0.0"
  source: https://huggingface.co
---

# Hugging Face UI Skills

Opinionated constraints for building Hugging Face-style interfaces with AI agents.

## When to Apply

Reference these guidelines when:
- Building dark-mode interfaces
- Creating Hugging Face-inspired design systems
- Implementing UIs with Inter font and 4px grid

## Colors

- MUST use dark backgrounds (lightness < 20) for primary surfaces - detected lightness: 7
- MUST use `#0D1119` as page background (`surface-base`)
- SHOULD reduce color palette (currently 13 colors detected)
- MUST maintain text contrast ratio of at least 4.5:1 for accessibility

### Semantic Tokens

| Token | HEX | RGB | Usage |
|-------|-----|-----|-------|
| `surface-base` | #0D1119 | rgb(13,17,25) | Page background |
| `surface-raised` | #FFFFFF | rgb(255,255,255) | Cards, modals, raised surfaces |
| `surface-overlay` | #171D2A | rgb(23,29,42) | Overlays, tooltips, dropdowns |
| `text-primary` | #3D3D3D | rgb(61,61,61) | Headings, body text |
| `text-secondary` | #909199 | rgb(144,145,153) | Secondary, muted text |
| `text-tertiary` | #4F4F57 | rgb(79,79,87) | Additional text |
| `border-default` | #0B0F16 | rgb(11,15,22) | Subtle borders, dividers |

## Typography

- MUST use `Inter` as primary font family
- SHOULD use single font family for consistency
- MUST use `61px` / `700` for primary headings
- MUST use `15px` / `500` for body text
- SHOULD reduce font weights (currently 4 detected)
- MUST use `text-balance` for headings and `text-pretty` for body text
- SHOULD use `tabular-nums` for numeric data
- NEVER modify letter-spacing unless explicitly requested

### Text Styles

| Style | Font | Size | Weight | Color | Count |
|-------|------|------|--------|-------|-------|
| `heading-1` | Inter | 61px | 700 | #E5E6E7 | 1 |
| `text-18px` | Inter | 18px | 500 | #303030 | 1 |
| `text-17px` | Inter | 17px | 500 | #3B3B3B | 1 |
| `text-17px` | Inter | 17px | 400 | #A9ACB1 | 1 |
| `text-17px` | Inter | 17px | 400 | #65676F | 1 |
| `body` | Inter | 15px | 500 | #353535 | 1 |
| `body-secondary` | Inter | 14px | 400 | #525252 | 2 |
| `body-secondary` | Inter | 14px | 400 | #3C3C3C | 1 |
| `body-secondary` | Inter | 14px | 500 | #383838 | 1 |
| `body-secondary` | Inter | 14px | 400 | #7F848C | 1 |

### Typography Reference

**Font Families:**
- `Inter` (used 106x)

**Font Sizes:** 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 17px, 18px, 61px

## Spacing

- MUST use 4px grid for spacing
- SHOULD use spacing from scale: 1px, 2px, 3px, 4px, 5px, 6px, 7px, 8px
- SHOULD use 2px as default gap between elements
- NEVER use arbitrary spacing values (use design scale)
- SHOULD maintain consistent padding within containers

## Borders

- MUST use border-radius from scale: 0px, 2px, 3px, 4px, 5px, 6px, 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 21px
- SHOULD use 21px+ radius for pill-shaped elements
- SHOULD limit border widths to: 1px, 2px, 5px
- SHOULD use 4px as default border-radius
- NEVER use arbitrary border-radius values (use design scale)
- SHOULD use subtle borders (1px) for element separation

### Border Radius Reference

**Scale:** 0px, 2px, 3px, 4px, 5px, 6px, 7px, 8px, 9px, 10px, 11px, 12px, 13px, 14px, 15px, 21px

## Layout

- MUST design for 1920px base viewport width
- SHOULD use consistent element widths: 12px, 10px, 14px, 9px, 11px
- SHOULD maintain text-heavy layout with clear hierarchy
- NEVER use `h-screen`, use `h-dvh` for full viewport height
- MUST respect `safe-area-inset` for fixed elements
- SHOULD use `size-*` for square elements instead of `w-*` + `h-*`

### Detected Layout Patterns

- **Main Content**: width: 1510px, height: 754px
- **Main Content**: width: 1103px, height: 796px
- **Header**: height: 60px

## Components

- MUST use `0px` height for input fields

### Buttons

| Variant | Background | Text | Border | Height | Radius |
|---------|------------|------|--------|--------|--------|
| Ghost | transparent | #777B84 | none | - | - |

### Inputs

- Height: `0px`

## Interactive States

### Focus

- MUST use `2px` outline with accent color (`#5E6AD2`)
- MUST use `2px` outline-offset
- NEVER remove focus indicators

### Hover

- Buttons (primary): lighten background by 10%
- Buttons (secondary): use `#FFFFFF` background
- List items: use `#FFFFFF` background

### Disabled

- MUST use `opacity: 0.5`
- MUST use `cursor: not-allowed`

## Interaction

- MUST use an `AlertDialog` for destructive or irreversible actions
- SHOULD use structural skeletons for loading states
- MUST show errors next to where the action happens
- NEVER block paste in `input` or `textarea` elements
- MUST add an `aria-label` to icon-only buttons

## Animation

- NEVER add animation unless it is explicitly requested
- MUST animate only compositor props (`transform`, `opacity`)
- NEVER animate layout properties (`width`, `height`, `top`, `left`, `margin`, `padding`)
- SHOULD use `ease-out` on entrance animations
- NEVER exceed `200ms` for interaction feedback
- SHOULD respect `prefers-reduced-motion`

## Performance

- NEVER animate large `blur()` or `backdrop-filter` surfaces
- NEVER apply `will-change` outside an active animation
- NEVER use `useEffect` for anything that can be expressed as render logic

© design-skills · MIT · ihlamury/design-skills

Similar skills

All skills for Design →

From the same set13

The whole set →
airbnb-ui-skills airbnb-ui-skills is a Claude Code skill that defines rules for generating Airbnb-inspired light interfaces, including the color palette, Inter font, 4px grid, and CSS animation limits. CX Codex +1 423installs notion-ui-skills notion-ui-skills enforces Notion design system guidelines with a 4px grid and light-mode tokens. CX Codex +1 417installs figma-ui-skills Applies Figma UI constraints: light mode, Inter font, and a 4px grid. Keeps coding agents from picking random spacing, colors, or heavy layout animations. CX Codex +1 374installs vercel-ui-skills vercel-ui-skills — a skill for Claude Code, Cursor and other platforms that teaches the agent to build Vercel-style interfaces: light background #F9F9F9, Inter font, 4px grid and precise token palette. CX Codex +1 372installs framer-ui-skills framer-ui-skills hands the agent a fixed set of Framer-style UI rules: dark surfaces, Inter, a 4px grid. Useful when you want a predictable look without hand-tweaking every value. CX Codex +1 352installs anthropic-ui-skills anthropic-ui-skills hands your agent a fixed set of rules for Anthropic-style interfaces: light surfaces, Inter, a 4px grid. Useful when you keep re-explaining the palette in every prompt. CX Codex +1 340installs copy-ai-ui-skills copy-ai-ui-skills is a Claude Code skill that guides interface creation in Copy Ai style, with a light theme, Inter, and a 4px grid for a cohesive visual system. CX Codex +1 275installs weights-biases-ui-skills weights-biases-ui-skills — a skill for Weights & Biases-style interfaces with light surfaces, Inter, a 4px spacing grid, and rules for interaction, accessibility, and motion. CX Codex +1 262installs

Project sponsors

Companies that keep this analytics open