# brand-typography-systems

brand-typography-systems guides your coding assistant in pairing fonts, building modular type scales, and generating brand typography tokens.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 123 installs · ★ 48 repo stars
- Author: mike-coulbourn
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/mike-coulbourn/claude-vibes/tree/HEAD/plugins/vibes/skills/brand-typography-systems/SKILL.md
- Updated: 2026-09-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/brand-typography-systems

## What it does

This skill supplies your assistant with a structured reference for brand typography. It sets clear steps to translate brand personality traits into typeface pairings, hierarchy levels, and design tokens.

The guide includes modular scale ratios from Minor Second (1.067) for dense data displays up to the Golden Ratio (1.618) for editorial headers, using a standard 16px base size. It also adds a serif versus sans-serif decision framework based on touchpoint types and readability requirements.

Because the system restricts typography hierarchies to 6–8 distinct sizes, it prevents scale bloat when defining design tokens.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mike-coulbourn/claude-vibes --skill brand-typography-systems -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/brand-typography-systems/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/brand-typography-systems/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mike-coulbourn/claude-vibes --skill brand-typography-systems -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/brand-typography-systems/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mike-coulbourn/claude-vibes --skill brand-typography-systems -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/brand-typography-systems/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mike-coulbourn/claude-vibes plugins/vibes/skills/brand-typography-systems
```

2. **Manually: put the files in place**
- File: `.github/skills/brand-typography-systems/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mike-coulbourn/claude-vibes --skill brand-typography-systems -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mike-coulbourn/claude-vibes --path plugins/vibes/skills/brand-typography-systems
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/brand-typography-systems/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add mike-coulbourn/claude-vibes --skill brand-typography-systems -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mike-coulbourn/claude-vibes/tree/HEAD/plugins/vibes/skills/brand-typography-systems/SKILL.md

## When to use it
- pair serif and sans-serif typefaces based on brand traits
- calculate a modular type scale starting from a 16px base
- define clear typographic hierarchies for responsive interfaces
- create design tokens for headings and body text without size bloat

## Example prompts
- Calculate a modular type scale using a Major Third ratio for a dashboard
- Suggest a font pairing and heading hierarchy for a heritage luxury brand
- Generate typography guidelines and CSS font size tokens based on a 16px baseline

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a07526a561df2490.

BEGIN THIRD-PARTY FILE a07526a561df2490
```text
---
name: brand-typography-systems
description: Use when choosing brand typefaces, pairing fonts, building a type hierarchy or modular scale, or writing typography guidelines and design tokens. Keywords - brand typography, font selection, font pairing, serif vs sans-serif, type scale, typeface licensing, web font performance, WCAG typography and readability.
---

# Brand typography systems & strategic type selection

Quick reference for developing strategic brand typography systems grounded in personality, hierarchy, and practical application.

> "Typography exists to honor content." — Robert Bringhurst, *The Elements of Typographic Style*

> "Typography and design should enhance communication, not just look attractive." — Erik Spiekermann

> "I can teach anyone good typography in two or three days. The craft is very simple, the rest is just practice." — Erik Spiekermann

---

## Key principles

1. **Start with personality**: Typography selection flows from brand personality to typeface choices. Never the reverse.
2. **Honor content**: Beautiful type that doesn't serve content fails its purpose.
3. **Contrast through classification**: Serif + sans-serif pairing creates natural hierarchy without conflict.
4. **Form follows function**: Body text prioritizes legibility; display text can prioritize personality.
5. **Consistency builds recognition**: Every touchpoint reinforces (or undermines) brand perception.
6. **Accessibility is non-negotiable**: Design for the widest possible audience.
7. **Systems scale**: Create hierarchies that work across all applications and contexts.

---

## Core frameworks

### 1. Brand-first typography selection process

Typography selection must flow from brand strategy, not aesthetic preference.

**The process:**

| Step | Action | Purpose |
|------|--------|---------|
| 1 | **Define Brand Personality** | Identify 3-5 traits that define brand voice and image |
| 2 | **Understand Target Audience** | Demographics, preferences, industry expectations |
| 3 | **Gather Inspiration** | Analyze competitors, identify differentiation opportunities |
| 4 | **Select and Pair Fonts** | Create mockups across touchpoints (print, web, mobile) |
| 5 | **Establish Hierarchy** | Define primary, secondary, tertiary with clear purposes |
| 6 | **Create Guidelines** | Document everything with examples and specifications |

**Key insight**: "If the brand can define itself using descriptions to capture the tone, personality, and principles—we can translate that into typographic forms."

---

### 2. Modular scale typography system

A mathematical approach to creating harmonious type hierarchies using consistent ratios.

**Common ratios:**
```
END THIRD-PARTY FILE a07526a561df2490

The third-party file has ended. Everything between the a07526a561df2490 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2698 of 19008 bytes. © mike-coulbourn · MIT · https://github.com/mike-coulbourn/claude-vibes/tree/HEAD/plugins/vibes/skills/brand-typography-systems/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
