agentleFS
castle-xcastle-x/skills-x/skills/minimal-ui-design/SKILL.md

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.

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
  1. Distinctive:

    Create UIs that feel calm and minimal without sacrificing clarity.

    line 10
  2. Distinctive:

    Do NOT use when the goal is a marketing/brand-heavy or storytelling UI.

    line 20
  3. Distinctive:

    Remove duplicates and verbose labels first.

    line 25
  4. Distinctive:

    Keep one minimal cue per area (placeholder, tooltip, or keycap row).

    line 26
  5. Distinctive:

    Use icons for primary actions.

    line 29
  6. Very specific:

    Always include aria-label/title for meaning and onboarding.

    line 30
  7. Distinctive:

    Prefer icon-only + tooltip.

    line 31
  8. Distinctive:

    Use subtle keycap rows or tiny tooltips over large help panels.

    line 34
  9. Distinctive:

    Keep hint text to 1–4 words.

    line 35
  10. Distinctive:

    Use consistent spacing scale.

    line 39
  11. Distinctive:

    Avoid showing the same shortcut in multiple places.

    line 44
  12. Distinctive:

    Remove repeated labels, “empty state” descriptions, and duplicate headers.

    line 49
  13. Distinctive:

    If you add a keycap row, remove other shortcut hints nearby.

    line 56
  14. Distinctive:

    Use a single shortcut bar (keycaps) when helpful.

    line 63
  15. Distinctive:

    Keep labels in accessibility attributes.

    line 64
  16. Distinctive:

    Use small, consistent icon sizes.

    line 65
  17. Distinctive:

    Use subtle active states (theme-tinted, low opacity).

    line 66
  18. Distinctive:

    Add a settings toggle just to show labels.

    line 69

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. Reduce, don’t hide
    • Remove duplicates and verbose labels first.
    • Keep one minimal cue per area (placeholder, tooltip, or keycap row).
  2. Icon-first, never icon-only without labels
    • Use icons for primary actions.
    • Always include aria-label/title for meaning and onboarding.
    • Prefer icon-only + tooltip; use visible text only when confusion remains.
  3. Guidance must be low-noise
    • Use subtle keycap rows or tiny tooltips over large help panels.
    • Keep hint text to 1–4 words.
  4. Density with breathing
    • Compact spacing, but avoid reducing font size to “fake minimal”.
    • Use consistent spacing scale; keep touch targets ≥ 44×44.
  5. 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)

  1. Delete redundancy
    • Remove repeated labels, “empty state” descriptions, and duplicate headers.
  2. Collapse controls
    • Merge similar actions into a single toggle or icon button.
  3. Replace text with icons
    • Convert button text to icons, keep labels via aria-label/title.
  4. Re-add minimal guidance
    • Choose ONE: placeholder, tooltip, or keycap row.
    • If you add a keycap row, remove other shortcut hints nearby.
  5. 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,减少信息密度但保留清晰路径。”

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.