google-fonts-skill — Claude Code skill: pick Google Fonts and type scales
Searches Google Fonts by mood and personality, suggests pairings that work, and hands back CSS variables, a Tailwind config and embed links.
MIT 210 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill google-fonts-skill -a claude-codeWhat google-fonts-skill does
Give it a mood or a personality and it searches a dataset where each family carries tags for contrast, mood, body-text suitability and quality tier. Two modes: one family for headings and body, or a pair taken from combinations known to sit well together.
What comes back is code you can paste: CSS custom properties, a Tailwind config, embed links, and a choice of modular type scales. scripts/search.py does the lookup, scripts/generate-css.py writes the styles. Both run on Python 3, so without it the skill has nothing to execute.
An MCP route exists too: claude mcp add google-fonts -- uvx google-fonts-mcp, which wants uv on the machine. With that server connected the skill reaches for its tools first. Adobe Fonts, self-hosted files and other non-Google sources are outside its scope, and axis-level variable font tuning belongs in the font's own docs.
What it helps with
- Find a heading and body pairing that holds up in real layouts
- Generate CSS variables and a Tailwind config for the chosen family
- Pick a font by mood instead of scrolling the whole catalogue
- Build a modular type scale for a page
- Get Google Fonts embed links without assembling the URL by hand
Example prompts for the agent
- Pick a Google Fonts pair for a plain docs site and show me the CSS custom properties
- Build a modular type scale and a Tailwind config for that pair
- Find a warm body font and give me the embed link
How to install google-fonts-skill
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill google-fonts-skill -a claude-code2Manually: put the files in place
~/.claude/skills/google-fonts-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/google-fonts-skill/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill google-fonts-skill -a codex2Manually: put the files in place
.agents/skills/google-fonts-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill google-fonts-skill -a cursor2Manually: put the files in place
.cursor/skills/google-fonts-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/google-fonts-skill2Manually: put the files in place
.github/skills/google-fonts-skill/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill google-fonts-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/google-fonts-skillManually: put the files in place
.devin/skills/google-fonts-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill google-fonts-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about google-fonts-skill
How do I install google-fonts-skill in Claude Code?
Run npx skills add podo/design-agent-skills --skill google-fonts-skill -a claude-code. The skill file lands at ~/.claude/skills/google-fonts-skill/SKILL.md.
What does google-fonts-skill do?
It looks up Google Fonts by mood and personality tags, proposes proven pairings, and writes CSS custom properties, a Tailwind config, embed links and modular scales.
Does it need anything installed to work?
Python 3, because scripts/search.py and scripts/generate-css.py are Python. The MCP variant needs uv: claude mcp add google-fonts -- uvx google-fonts-mcp.
Source text
SKILL.md · MIT
--- name: google-fonts-skill description: | Searches Google Fonts enriched with personality and mood tags, suggests proven pairings, generates CSS custom properties, Tailwind config, and embed links, and offers modular type scales. Works as a skill with bundled Python scripts, or as an MCP server. triggers: - "Google Fonts" - "font pairing" - "typography skill" - "google-fonts-skill" - "modular scale" - "font mood" - "font personality" das: type: skill category: visual-components upstream: "https://github.com/sliday/google-fonts-skill" upstream_path: "SKILL.md" version: latest install: true --- # google-fonts-skill > Catalogue stub — full skill: [sliday/google-fonts-skill](https://github.com/sliday/google-fonts-skill) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `google-fonts`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/google-fonts/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/google-fonts/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `google-fonts`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/google-fonts-skill ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add sliday/google-fonts-skill --skill google-fonts -g -y ``` **Project:** ```bash npx skills add sliday/google-fonts-skill --skill google-fonts -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Claude Code plugin route:** ``` claude plugin marketplace add sliday/google-fonts-skill claude plugin install google-fonts@google-fonts-skill ``` **Heads-up** - **Requires:** Python 3 (a skill-only install runs the bundled scripts/search.py and scripts/generate-css.py) - **License:** MIT <!-- das:install:end --> ## Invoke after install - Skill name: `google-fonts` - Trigger phrases: "Google Fonts", "font pairing", "modular scale", "choose a font", "type scale" ## What it does Provides Google Fonts selection backed by an enriched font dataset (personality, contrast, mood, body suitability, quality tier). Runs in single-font mode (one font for headings and body) or pair mode (searches proven pairings first), then generates ready-to-use CSS custom properties, Tailwind configuration, and Google Fonts embed links, with a choice of modular type scales. As a skill it searches the bundled data with `scripts/search.py` and `scripts/generate-css.py`. Optional MCP route: upstream also ships the same tools as an MCP server (`claude mcp add google-fonts -- uvx google-fonts-mcp`, needs `uv`); the installed skill prefers the MCP tools when that server is connected. ## When NOT to use - Non-Google font sources (self-hosted, Adobe Fonts, etc.) - Complete brand typography system needing token architecture — pair with `design-tokens-skill` - Variable font fine-tuning at axis level — consult font-specific documentation
© podo · MIT · podo/design-agent-skills