make-interfaces-better — Claude Code skill
make-interfaces-better — a skill for Claude Code, Cursor, Codex and other platforms that teaches the agent to make interfaces feel genuinely alive. Applies Jakub Krehel's design engineering principles — creator of oklch.fyi and Interfaces.
MIT 219 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill make-interfaces-better -a claude-codeWhat make-interfaces-better does
The skill trains the agent to notice the details that shift an interface from "works" to "feels right". That means transition timing, precise font choices, spacing rhythm, hover states, micro-interactions and visual hierarchy.
Inside are rules from Jakub Krehel (Interfere, Interfaces, oklch.fyi). Install via npx skills add or gh skill install depending on the platform. MIT licensed.
If the agent outputs a component without transitions or a button without hover feedback, this skill brings it to a polished, finished state.
What it helps with
- refine draft UI to a polished, complete state
- dial in animation timing and transitions
- choose the right typeface weight and size
- structure visual hierarchy across elements
- add micro-interactions: hovers, focus states, feedback
Example prompts for the agent
- Polish this component: add transitions, hovers and proper spacing
- Check the interface for micro-interactions and visual hierarchy
- Make the UI feel alive — set up animations and states
How to install make-interfaces-better
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill make-interfaces-better -a claude-code2Manually: put the files in place
~/.claude/skills/make-interfaces-better/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/make-interfaces-better/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill make-interfaces-better -a codex2Manually: put the files in place
.agents/skills/make-interfaces-better/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill make-interfaces-better -a cursor2Manually: put the files in place
.cursor/skills/make-interfaces-better/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/make-interfaces-better2Manually: put the files in place
.github/skills/make-interfaces-better/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill make-interfaces-better -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/make-interfaces-betterManually: put the files in place
.devin/skills/make-interfaces-better/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill make-interfaces-better -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 make-interfaces-better
How to install make-interfaces-better in Claude Code?
Run npx skills add podo/design-agent-skills --skill make-interfaces-better -a claude-code. The skill will install to ~/.claude/skills/make-interfaces-better/SKILL.md.
What does make-interfaces-better do?
Teaches the agent to apply Jakub Krehel's design engineering principles: transition timing, micro-interactions, precise typography, visual hierarchy. UI stops being merely functional and starts feeling right.
Which platforms support make-interfaces-better?
Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI and OpenCode. Install command depends on the platform — GitHub Copilot uses gh skill install, others use npx skills add.
Source text
SKILL.md · MIT
--- name: make-interfaces-better description: | Design engineering principles for making interfaces feel polished and alive. Covers micro-interactions, typography details, visual refinement, and the small decisions that separate "it works" from "it feels right". By Jakub Krehel (Interfere, Interfaces magazine, oklch.fyi). triggers: - "make interfaces better" - "interface polish" - "micro-interactions" - "interface feel" - "polished UI" - "UI refinement" das: category: interaction-polish upstream: "https://github.com/jakubkrehel/make-interfaces-feel-better" upstream_path: "skills/make-interfaces-feel-better/SKILL.md" version: latest install: true --- # make-interfaces-better > Catalogue stub — full skill: [jakubkrehel/make-interfaces-feel-better](https://github.com/jakubkrehel/make-interfaces-feel-better) <!-- 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 `make-interfaces-feel-better`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/make-interfaces-feel-better/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/make-interfaces-feel-better/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `make-interfaces-feel-better`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/make-interfaces-better ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add jakubkrehel/make-interfaces-feel-better --skill make-interfaces-feel-better -g -y ``` **Project:** ```bash npx skills add jakubkrehel/make-interfaces-feel-better --skill make-interfaces-feel-better -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **License:** MIT <!-- das:install:end --> ## Invoke after install - Skill name: `make-interfaces-feel-better` - Trigger phrases: "make interfaces better", "interface polish", "micro-interactions", "polished UI" ## What it does Applies Jakub Krehel's design engineering principles to make interfaces feel genuinely polished — not just functional. Covers micro-interactions, precise typography choices, visual hierarchy refinement, motion timing, and the subtle details (hover states, transitions, spacing rhythm) that distinguish well-crafted UI from generic output. By the creator of oklch.fyi and the Interfaces publication.
© podo · MIT · podo/design-agent-skills