minimal-ui-design
Skill18 starsChanged 7 months agoMITView on GitHub
Use when designing or refining UIs that must be visually minimal, low-noise, and icon-forward while staying understandable for new users, especially when reducing text, consolidating controls, or streamlining dialogs, toolbars, search panels, or list results.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- brainstormingSkill
- dispatching-parallel-agentsSkill
- executing-plansSkill
- find-skillsSkill
- finishing-a-development-branchSkill
- golang-cli-cobra-viperSkill
- golang-testingSkill
- receiving-code-reviewSkill
- requesting-code-reviewSkill
- skill-creatorSkill
- skills-xSkill
- subagent-driven-developmentSkill
- systematic-debuggingSkill
- test-driven-developmentSkill
- using-superpowersSkill
- verification-before-completionSkill
- writing-plansSkill
- writing-skillsSkill
- baidu-speech-to-textSkill
- feishu-notifySkill
- go-embedded-spaSkill
- go-i18nSkill
- go-pocketbase-integrationSkill
- shadowrocket-claude-routingSkill
- skills-xSkill
- tui-designSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
18 rules. About 0 are common, 17 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈17
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Create UIs that feel calm and minimal without sacrificing clarity.
- Distinctive: line 20
Do NOT use when the goal is a marketing/brand-heavy or storytelling UI.
- Distinctive: line 25
Remove duplicates and verbose labels first.
- Distinctive: line 26
Keep one minimal cue per area (placeholder, tooltip, or keycap row).
- Distinctive: line 29
Use icons for primary actions.
- Very specific: line 30
Always include aria-label/title for meaning and onboarding.
- Distinctive: line 31
Prefer icon-only + tooltip.
- Distinctive: line 34
Use subtle keycap rows or tiny tooltips over large help panels.
- Distinctive: line 35
Keep hint text to 1–4 words.
- Distinctive: line 39
Use consistent spacing scale.
- Distinctive: line 44
Avoid showing the same shortcut in multiple places.
- Distinctive: line 49
Remove repeated labels, “empty state” descriptions, and duplicate headers.
- Distinctive: line 56
If you add a keycap row, remove other shortcut hints nearby.
- Distinctive: line 63
Use a single shortcut bar (keycaps) when helpful.
- Distinctive: line 64
Keep labels in accessibility attributes.
- Distinctive: line 65
Use small, consistent icon sizes.
- Distinctive: line 66
Use subtle active states (theme-tinted, low opacity).
- Distinctive: line 69
Add a settings toggle just to show labels.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Minimal UI Design
Overview
Create UIs that feel calm and minimal without sacrificing clarity. Prioritize reduced copy, icon-led actions, and subtle guidance that keeps new users oriented.
When to Use
- The user asks for minimal, clean, or low-noise UI.
- You are removing redundant text or simplifying dense layouts.
- You are switching text buttons to icon-only controls.
- You need to keep a UI beginner-friendly after simplification.
- You are redesigning search dialogs, toolbars, or action bars.
Do NOT use when the goal is a marketing/brand-heavy or storytelling UI.
Core Principles
- Reduce, don’t hide
- Remove duplicates and verbose labels first.
- Keep one minimal cue per area (placeholder, tooltip, or keycap row).
- Icon-first, never icon-only without labels
- Use icons for primary actions.
- Always include
aria-label/titlefor meaning and onboarding. - Prefer icon-only + tooltip; use visible text only when confusion remains.
- Guidance must be low-noise
- Use subtle keycap rows or tiny tooltips over large help panels.
- Keep hint text to 1–4 words.
- Density with breathing
- Compact spacing, but avoid reducing font size to “fake minimal”.
- Use consistent spacing scale; keep touch targets ≥ 44×44.
- Keep the editing flow keyboard-first
- Shortcut hints belong in a single, quiet strip.
- Show only shortcuts that are usable in the current surface.
- Avoid showing the same shortcut in multiple places.
Workflow (Minimal UI Pass)
- Delete redundancy
- Remove repeated labels, “empty state” descriptions, and duplicate headers.
- Collapse controls
- Merge similar actions into a single toggle or icon button.
- Replace text with icons
- Convert button text to icons, keep labels via
aria-label/title.
- Convert button text to icons, keep labels via
- Re-add minimal guidance
- Choose ONE: placeholder, tooltip, or keycap row.
- If you add a keycap row, remove other shortcut hints nearby.
- Check clarity
- Can a new user pass a 10-second scan test?
Quick Reference
Do
- Use a single shortcut bar (keycaps) when helpful.
- Keep labels in accessibility attributes.
- Use small, consistent icon sizes.
- Use subtle active states (theme-tinted, low opacity).
Don’t
- Add a settings toggle just to show labels.
- Show multi-line help blocks inside minimal dialogs.
- Shrink font size to “look clean”.
- Duplicate hints in multiple locations.
- Reintroduce visible labels everywhere by default.
Common Mistakes
- Over-hiding: icon-only without labels or tooltips.
- Help bloat: adding a help panel defeats minimalism.
- False minimal: tiny fonts and tight line-height reduce readability.
- Conflicting cues: shortcut hints shown in both header and footer.
- Global hints: showing shortcuts that don’t apply in the current UI.
Example (Condensed)
User: “搜索框要极简、图标化,但新手也要能用。”
Response: “移除冗余文案,保留 1 个引导(占位符或 keycap 条),按钮改图标并补 aria-label,减少信息密度但保留清晰路径。”
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

