Skip to content
Back to search

digital-minimalist-design

An Agent Skill for calm software: monochrome, text-first, one-purpose app design with measured type & spacing. (EN/KO)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tingoofriend--digital-minimalist-design/badge.svg)](/listings/tingoofriend--digital-minimalist-design)

HTML

<a href="/listings/tingoofriend--digital-minimalist-design"><img src="/api/listings/tingoofriend--digital-minimalist-design/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code / any agent using the `skills` CLI**

npx skills add tingoofriend/digital-minimalist-design

Or copy the folder manually:

cp -r skills/digital-minimalist-design ~/.claude/skills/

**Claude apps (claude.ai / desktop)** Zip the `skills/digital-minimalist-design` folder and upload it from the Skills section of Claude's settings.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 96 lines
  1. # digital-minimalist-design
  2. **An Agent Skill for calm software.** It teaches Claude (and other skill-compatible agents) to design apps that do one thing, stay out of the way, and are often used without being opened at all: monochrome, text-first, widget-first.
  3. [한국어 README](README.ko.md)
  4. ![Before and after: a typical colorful to-do app vs. the same app with this skill](docs/images/before-after.png)
  5. <sub>Left: an illustrative "typical default" I made by hand to show common patterns. It is not real model output. Right: the same content after applying this skill.</sub>
  6. ## Why another minimalist skill?
  7. Most minimalist UI skills are about **aesthetics**: editorial web layouts, bento grids, muted palettes. This one is about **attention**:
  8. - **Product principles, not just style.** Do one thing. Be useful without opening the app. Add deliberate friction before compulsive actions. No badges, streaks, or feeds.
  9. - **Measured, not guessed.** Type sizes, spacing, and grays were pixel-measured from real reference apps (see [`measurements.md`](skills/digital-minimalist-design/references/measurements.md)).
  10. - **Surfaces beyond the screen.** Widgets, Lock Screen, Live Activities, the Dynamic Island, and the macOS menu bar are first-class.
  11. - **Multi-platform.** iOS, Android, web, macOS, and e-ink / low-stimulus modes, plus CJK typography notes.
  12. ## What's inside
  13. ```
  14. skills/digital-minimalist-design/
  15. ├── SKILL.md # the skill (English, canonical)
  16. └── references/
  17. ├── measurements.md # how values were measured, raw numbers, error margins
  18. └── tokens.css # drop-in CSS tokens (light + dark)
  19. docs/
  20. ├── SKILL.ko.md # Korean version
  21. └── images/ # README images
  22. examples/
  23. └── onething-mockup.html # example mockup built with the skill
  24. ```
  25. Highlights from `SKILL.md`:
  26. | | |
  27. |---|---|
  28. | Colors | bg `#F7F7F7` / `#000`, text-2 `#808080`, text-3 `#BBBBBB`, divider `#E2E2E2`, no accent |
  29. | Type | header 20 pt Semibold · row 15 pt · meta 12 pt · content title 40–44 pt Bold |
  30. | Layout | 20 pt margins · 20 pt round checkboxes · 56/59 pt rows · 44 pt circular buttons |
  31. | Patterns | text launcher, big-answer widget, dot-grid progress, single note, focus mode, intervention screen, text-first player, menu-bar popover |
  32. ## Install
  33. **Claude Code / any agent using the `skills` CLI**
  34. ```bash
  35. npx skills add tingoofriend/digital-minimalist-design
  36. ```
  37. Or copy the folder manually:
  38. ```bash
  39. cp -r skills/digital-minimalist-design ~/.claude/skills/
  40. ```
  41. **Claude apps (claude.ai / desktop)**
  42. Zip the `skills/digital-minimalist-design` folder and upload it from the Skills section of Claude's settings.
  43. ## Usage
  44. The skill loads automatically when you ask for UI work. You can also name it:
  45. > Design a habit tracker using the digital-minimalist-design skill. Start with the widget.
  46. > Build the settings screen for my SwiftUI app in the digital minimalist style.
  47. ## Example
  48. ![Example mockup: list, home screen widgets, focus, lock screen, intervention, detail, menu bar, web](docs/images/showcase.png)
  49. Open [`examples/onething-mockup.html`](examples/onething-mockup.html) in a browser. The phone screens are built at a real 393×852 pt and shown at 68% scale.
  50. ## Limitations
  51. - Values were measured from promotional screenshots, so they carry about ±1 pt error for type and ±2 pt for spacing. They are references, not specs.
  52. - The system is tuned for iPhone first; Android and web sections are adaptations.
  53. - One opinionated style. If your product needs a brand color or dense data views, use this skill as a starting point rather than a rulebook.
  54. ## Credits and attribution
  55. - The style was distilled from the app curation published on the [Digital Minimalist blog](https://www.digitalminimalist.com/blog). This project is **not affiliated** with that blog.
  56. - App names in `SKILL.md` are cited only as style references. All trademarks belong to their owners. No third-party screenshots are included in this repository; all images were made for this project.
  57. ## Contributing
  58. Issues and PRs are welcome, especially:
  59. - measurements from more reference apps (please include your method)
  60. - Android / Jetpack Compose and web component examples
  61. - translations
  62. ## License
  63. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.