Agent skill

Wabi Sabi Restraint

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work.

Apache-2.0Auto-check passedFrontend & Design

Install Wabi Sabi Restraint

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill wabi-sabi-restraint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins wabi-sabi-restraint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/wabi-sabi-restraint .claude/skills/wabi-sabi-restraint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wabi-sabi-restraint
GitHub stars
1.3k
Token cost
~2.2k tokens
SKILL.md length
1,103 words
Files
2 (incl. references)
Skills in repo
716
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work.

  • Designing reading-focused interfaces
  • SKILL.md covers What restraint looks like, Why restraint matters, When restraint is the right… and When too much restraint…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Paring back accumulated clutter

What it does

Wabi Sabi Restraint is an agent skill from hashgraph-online/awesome-codex-plugins. Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work. Use when designing reading-focused interfaces, paring back accumulated clutter, choosing between decoration and absence, or evaluating whether each element earns its place. Restraint is the often-overlooked half of wabi-sabi: the imperfection side gets attention, but the principle is equally about modesty and the elegance of what's not there.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/restraint-checklist.md`).

It sits in Frontend & Design. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Designing reading-focused interfaces
  • Paring back accumulated clutter
  • Choosing between decoration and absence
  • Evaluating whether each element earns its place

Example prompts

  • “/wabi-sabi-restraint”

What it can do on your machine

Read from SKILL.md and the folder at commit 3e1456a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wabi Sabi Restraint loads about 2.2k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 1,103 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~127
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 3e1456a, republished under its Apache-2.0 licence (© hashgraph-online). 1,103 words, ~2,156 tokens.

Download SKILL.mdSave it as .claude/skills/wabi-sabi-restraint/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
wabi-sabi-restraint
description
Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work. Use when designing reading-focused interfaces, paring back accumulated clutter, choosing between decoration and absence, or evaluating whether each element earns its place. Restraint is the often-overlooked half of wabi-sabi: the imperfection side gets attention, but the principle is equally about modesty and the elegance of what's not there.

Wabi-Sabi — restraint

The other half of wabi-sabi: restraint. The discipline of leaving things out, of resisting decoration, of letting empty space carry the design. Where the imperfection side adds warmth through visible craft, the restraint side adds elegance through what's not there.

The two halves work together. Pure imperfection without restraint becomes kitsch. Pure restraint without imperfection becomes cold minimalism. The Japanese tea room embodies both: the materials are humble and slightly irregular (imperfection), but the space is sparse and uncluttered (restraint).

In digital design, restraint is often the more useful half. Most products suffer from too much decoration, not too little. Too many features competing for attention; too many visual flourishes; too many options the user has to evaluate. Restraint corrects this.

What restraint looks like

Generous whitespace. Empty space around content lets the content breathe. The absence is doing design work.

Single focal point per view. Each screen has one primary thing the user is meant to focus on; supporting elements step back.

Limited color palette. Five or six colors with clear roles, used disciplined, rather than fifteen colors used arbitrarily.

Few typefaces. Two or three typefaces (or weights of one), not a typographic zoo.

Resistance to decoration. No element added unless it earns its place. Visual elements serve function, not just visual interest.

Silence in interaction. Not every action needs animation; not every state needs a visual flourish. Quiet interactions for quiet moments.

Resistance to feature creep. Features added only when they earn their place. The product stays focused.

Editorial discipline in copy. Words used carefully; nothing added that doesn't say something. Brevity and precision.

Why restraint matters

Restraint produces several benefits:

Focus. Users know where to look. The single focal point is unambiguous.

Speed. Less to render, fewer choices to make, faster to use.

Maintainability. Fewer elements means fewer things to update, fix, or redesign.

Timelessness. Trends in decoration date quickly; restrained designs age well.

Elegance. Simplicity reads as refinement; clutter reads as lack of editorial discipline.

Approachability. A spare design feels welcoming; a busy design feels intimidating.

The cost of restraint is that it requires saying no — often to suggestions for additions, decorations, features. The discipline is unglamorous but valuable.

When restraint is the right register

Restraint fits almost any context, but is especially valuable in:

Reading-focused products. Articles, documentation, e-books. Anything where the user needs to focus on text.

Functional tools. Products where the user is doing real work; visual decoration distracts.

Premium / luxury brands. Restraint reads as confidence; decoration reads as trying too hard.

Mature products. Once a product has accumulated complexity, restraint is the corrective.

International audiences. Restrained designs translate more cleanly across cultures than richly decorated ones.

When too much restraint becomes a problem

Restraint can be overdone:

Coldness. Pure restraint without warmth can feel sterile. Combine with selective imperfection.

Loss of brand identity. A maximally restrained product may not differentiate. Some products need character; restraint alone doesn't provide it.

Over-stripping for aesthetic. Removing things users actually need because "restraint." Function still matters.

Interface that doesn't communicate. A button with no visible affordance because "restraint." Users need cues to interact.

The line between elegant restraint and stark coldness is real. Calibrate based on the product's purpose.

Worked examples

A reading-focused content site

A long-form content site uses extreme restraint:

  • Single column of text, generous margins.
  • Two typefaces (a body serif and a display serif).
  • Minimal chrome (a small header, no sidebar, no footer ads).
  • Generous whitespace around images and pull quotes.
  • No autoplay video, no popup, no scroll-triggered effects.

The restraint serves reading. The user can focus on the content; the design steps back. This is restraint as functional virtue.

A SaaS dashboard with restraint

A SaaS dashboard uses restraint in its design system:

  • Five colors with clear roles (primary, secondary, success, warning, error).
  • One typeface in three weights.
  • Consistent spacing on a single scale.
  • Cards with subtle backgrounds rather than borders.
  • No animation other than functional state changes.

The dashboard reads as professional and considered. New features can be added without fighting decoration; the design system has room.

Show full SKILL.md (425 more words)Show less
A product that strips too much

A productivity app aggressively simplifies: removes labels under icons; removes button borders; uses very low color contrast for "subtle" feel. The result: users can't tell what's clickable, can't read low-contrast text, can't navigate. The restraint went past elegance into dysfunction.

The fix: restore enough cues for the interface to communicate. Restraint is a means, not an end.

A meditation app combining restraint and warmth

A meditation app uses restraint in its primary chrome (clean layout, generous whitespace, single typeface) but adds warmth in selected moments (hand-drawn opening illustration, occasional watercolor textures, warm color palette).

The combination is the right register: restraint for function, warmth for emotional moments. Both halves of wabi-sabi working together.

A landing page with restraint

A startup's landing page has:

  • A single headline.
  • A subhead.
  • A single CTA button.
  • An image (or no image).
  • Minimal navigation.

That's it. No animated background, no scrolling effects, no testimonial carousel, no fold-after-fold of features. The restraint reads as confidence: the product speaks for itself.

This is the opposite of the typical maximalist landing page. Both can work; restrained landing pages tend to age better and convert better for considered purchases.

Anti-patterns

Restraint at the cost of communication. Removing labels, lowering contrast, removing affordances. The interface stops working.

Cold restraint without warmth. Pure minimalism with no human touch. Reads as institutional or sterile.

Restraint as default styling. Stripping things by reflex without considering whether they were earning their place.

Restraint that doesn't extend to features. A visually-restrained product crammed with features. The visual restraint is undermined by feature complexity.

Restraint inconsistent with audience. A startup using ultra-restrained design when its audience expects energy and personality.

Confusing minimal with simple. A minimal-looking interface that's actually deeply complex (just hidden behind layers of disclosure). True restraint extends through the design, not just the surface.

Heuristic checklist

When applying restraint, ask: Does each element earn its place? If not, remove it. Is whitespace doing design work? Generous whitespace can carry meaning. Are there too many colors / typefaces / styles? Reduce to the minimum that serves. Is the restraint coming at the cost of function? Communication should not be sacrificed for aesthetic. Is restraint balanced with appropriate warmth? Pure restraint can be cold; combine with selective wabi-sabi imperfection.

  • wabi-sabi — parent principle on imperfection and restraint.
  • wabi-sabi-imperfection — sibling skill on the warmth-through-imperfection half.
  • signal-to-noise-ratio — restraint maximizes signal.
  • ockhams-razor — the razor and restraint align: prefer simpler when equivalent.
  • form-follows-function — restraint helps form follow function.

See also

  • references/restraint-checklist.md — practical checklist for applying restraint to existing designs.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/wabi-sabi-restraint of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/restraint-checklist.md

Open the folder on GitHubat commit 3e1456a

Compare with similar skills

Wabi Sabi Restraint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wabi Sabi Restraint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wabi Sabi Restraint this skillhashgraph-online/awesome-codex-plugins1.3k—~2.2kAutomated safety check: PassApache-2.0
Web Artifacts Builderanthropics/skills180k40 repos~769Automated safety check: PassApache-2.0
React Doctormakeplane/plane61k12 repos~657Automated safety check: PassAGPL-3.0
Impeccablebestofjs/bestofjs3.1k26 repos~2.6kAutomated safety check: PassMIT
Figma Design System Builderwarpdotdev/warp65k2 repos~4.4kAutomated safety check: PassAGPL-3.0
Web Interface Guidelines Reviewervercel-labs/openreview1.7k97 repos~308Automated safety check: PassNone

Similar skills

  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 40 repos~769 tokens
    Frontend & DesignAuto-check passed
  • React Doctor

    makeplane/plane

    Scans React code for lint, accessibility, bundle size and architecture issues, reports a health score and checks that changes do not lower it.

    61k GitHub starsUsed in 12 repos~657 tokens
    Frontend & DesignAuto-check passed
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 26 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Builds or updates a design system in Figma from a codebase in ordered phases: discovery, variables and tokens, components, theming and documentation, with checkpoints.

    65k GitHub starsUsed in 2 repos~4.4k tokens
    Frontend & DesignAuto-check passed
  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 97 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Tailwindcss Development

    anonaddy/anonaddy

    Always invoke when the user's message includes 'tailwind' in any form.

    4.9k GitHub starsUsed in 10 repos~865 tokens
    Frontend & DesignAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 715 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Wabi Sabi Restraint

What does Wabi Sabi Restraint do?

Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work. Wabi Sabi Restraint is an agent skill from hashgraph-online/awesome-codex-plugins. Apply wabi-sabi restraint — the discipline of leaving things out, of resisting decoration, of letting empty space and silence do design work.

When should I use Wabi Sabi Restraint?

Wabi Sabi Restraint fits situations like: designing reading-focused interfaces; paring back accumulated clutter; choosing between decoration and absence; evaluating whether each element earns its place.

How do I install Wabi Sabi Restraint in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wabi-sabi-restraint -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/wabi-sabi-restraint in hashgraph-online/awesome-codex-plugins) into .claude/skills/wabi-sabi-restraint in your project. Claude Code loads it when a task matches its description.

How do I install Wabi Sabi Restraint in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wabi-sabi-restraint -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/aesthetics-and-emotion-principles/skills/wabi-sabi-restraint in hashgraph-online/awesome-codex-plugins) into .agents/skills/wabi-sabi-restraint in your project. Codex loads it when a task matches its description.

Can I use Wabi Sabi Restraint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill wabi-sabi-restraint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wabi-sabi-restraint, .gemini/skills/wabi-sabi-restraint, .github/skills/wabi-sabi-restraint and .opencode/skills/wabi-sabi-restraint in your project.

What does Wabi Sabi Restraint need to run?

SKILL.md names no scripts, command-line tools or credentials: Wabi Sabi Restraint is instructions for the agent only.

Does Wabi Sabi Restraint access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Wabi Sabi Restraint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Wabi Sabi Restraint use?

Wabi Sabi Restraint is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wabi Sabi Restraint use?

About 2.2k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Wabi Sabi Restraint?

Skills that share tags, products or a category with Wabi Sabi Restraint: Web Artifacts Builder (anthropics/skills, 180k stars), React Doctor (makeplane/plane, 61k stars), Impeccable (bestofjs/bestofjs, 3.1k stars) and Figma Design System Builder (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wabi Sabi Restraint?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,267 GitHub stars. The repository holds 716 skills in this directory. The repository was last updated on October 10, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.