Agent skill

S4h Aesthetic Elegance Testing

by human-avatar in human-avatar/skills-for-humanity

Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time.

MITAuto-check passed

Install S4h Aesthetic Elegance Testing

skills CLI
$ npx skills add human-avatar/skills-for-humanity --skill s4h-aesthetic-elegance-testing -a claude-code

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

GitHub CLI
$ gh skill install human-avatar/skills-for-humanity s4h-aesthetic-elegance-testing --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/human-avatar/skills-for-humanity.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/s4h-aesthetic-elegance-testing .claude/skills/s4h-aesthetic-elegance-testing && 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
s4h-aesthetic-elegance-testing
GitHub stars
231
Token cost
~1.4k tokens
SKILL.md length
735 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time.

  • SKILL.md covers Your Process, Human Check-in, Output Format and Notes, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

S4h Aesthetic Elegance Testing is an agent skill from human-avatar/skills-for-humanity. Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time. TRIGGERS: 'elegance test', 'is this too complex', 'over-engineered', 'is there a simpler way', 'does this feel right'.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Structured reasoning methodologies from history's most rigorous thinkers, packaged as Claude Code skills. The licence is MIT.

Example prompts

  • “elegance test”
  • “is this too complex”
  • “over-engineered”
  • “/s4h-aesthetic-elegance-testing”

What it can do on your machine

Read from SKILL.md and the folder at commit a30df8b. 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

S4h Aesthetic Elegance Testing loads about 1.4k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 735 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

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 human-avatar/skills-for-humanity at commit a30df8b, republished under its MIT licence (© human-avatar). 735 words, ~1,373 tokens.

Download SKILL.mdSave it as .claude/skills/s4h-aesthetic-elegance-testing/SKILL.md (or your agent's skills folder).
name
s4h-aesthetic-elegance-testing
description
Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time. TRIGGERS: 'elegance test', 'is this too complex', 'over-engineered', 'is there a simpler way', 'does this feel right'.

Aesthetic Elegance Testing

Complexity is the default outcome of design by committee, incremental revision, and deference to edge cases. Each addition is locally defensible. The cumulative result is a system no one would have designed on purpose. Elegance is not simplicity for its own sake — it is the property of a solution where every element earns its place and nothing obscures the core. This skill tests for that property.


Your Process

Step 1: State the Solution Describe the design, plan, system, or solution in enough detail to evaluate its parts. If it's a process, name the steps. If it's a system, name the components. If it's a strategy, name the moves.

Framing check: Confirm the specific solution before continuing. State what you've identified — the actual artifact being tested and its apparent purpose — in one sentence, then use AskUserQuestion:

  • Question: "I'm reading this as: [your one-sentence framing of the solution and what it is meant to accomplish]. Is that right?"
  • Header: "Framing"
  • Options:
    • Yes — proceed — framing is correct
    • Adjust — one element is off; user will correct it before you continue
    • Reframe — different situation than read; incorporate the correction before proceeding

Step 2: Define the Irreducible Core What is the minimum that does the job? State in one sentence what the solution must accomplish to succeed. Every element that doesn't directly serve this core is a candidate for removal. If you can't state the core in one sentence, the solution may not have one — which is itself a finding.

Step 3: Element Audit For each component, mechanism, layer, or step: is it necessary for the core job, or did it accrete over time to handle edge cases, satisfy stakeholder requests, hedge against unlikely scenarios, or address problems that may not exist? Label each clearly: necessary or accreted.

Step 4: Concept Count How many distinct concepts must a new person learn to understand and use this solution fully? Elegant solutions have fewer. Count them explicitly. Compare against the irreducible minimum — the number of concepts required if every accreted element were removed. The gap is the complexity overhead.

Step 5: Thirty-Second Explanation Test Can you explain the solution in 30 seconds to someone intelligent but unfamiliar with it? Attempt the explanation. If it requires more than 30 seconds, complexity may be genuine — or it may be a sign the design hasn't been thought through clearly enough to be simple. Both are worth knowing.

Step 6: Sources of Unnecessary Complexity For each accreted element: what introduced it, and what would removing it cost? Some removals are free — the element was pure noise. Some involve real trade-offs — the element serves a secondary purpose worth naming. Distinguish them explicitly.


Show full SKILL.md (293 more words)Show less

Human Check-in

Before proceeding, use the AskUserQuestion tool. State your interpretation of the situation in 1–2 sentences — what is being analyzed and what the core question is — then ask:

  • Question: "My read: [your 1–2 sentence interpretation]. How do you want to proceed?"
  • Header: "Scope"
  • Options:
    • Full analysis — Complete all steps, reasoning shown throughout
    • Key findings only — Bottom-line output, skip step-by-step detail
    • Accidental complexity only — What could be removed without losing anything that matters
    • Reframe — The read is off; correct it and the analysis will follow the corrected framing

Proceed based on their selection. If the user reframes, incorporate the correction before running any analysis.

Output Format

Core Job: [one sentence — what the solution must accomplish to succeed]

Element Audit

ElementNecessary or AccretedRationale
[component/mechanism/step][necessary / accreted][why it does or doesn't serve the core]

Concept Count: [n currently required] vs [n at irreducible minimum] — overhead: [gap]

30-Second Explanation Test: [pass / fail — include the actual attempt]

Sources of Unnecessary Complexity

Accreted ElementHow It Was IntroducedCost of Removal
[element][origin][what is lost if removed]

Recommended Simplifications: [specific removals or reductions, with trade-offs named]


Notes

The question is not "can we defend every element" but "does every element earn its place." Elements that can be defended are not the same as elements that are necessary — hold the higher bar. Elegance is achieved not when there is nothing left to add, but when there is nothing left to remove.


What's Next

After delivering this output, use AskUserQuestion to offer the next move:

  • Question: "Elegance tested. What's next?"
  • Header: "Next"
  • Options:
    • /s4h-aesthetic-simplicity-analysis — Simplify what elegance testing flagged as complex
    • /s4h-writing-prose-elevation — Elevate prose flagged as inelegant
    • /s4h-aesthetic-coherence-check — Verify that elegance is coherent with the whole
    • Done — Wrap up and synthesise what we have so far

© human-avatar, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/s4h-aesthetic-elegance-testing of human-avatar/skills-for-humanity.

Open the folder on GitHubat commit a30df8b

Compare with similar skills

S4h Aesthetic Elegance Testing 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.

S4h Aesthetic Elegance Testing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
S4h Aesthetic Elegance Testing this skillhuman-avatar/skills-for-humanity231—~1.4kAutomated safety check: PassMIT
Opportunity Solution Treephuryn/pm-skills27k—~1.1kAutomated safety check: PassMIT
Google Cloud Solution Architecturegoogle/skills21k—~3.5kAutomated safety check: PassApache-2.0
D365 Solution Blueprintgithub/awesome-copilot40k—~2.7kAutomated safety check: PassMIT
Complexity Cutssickn33/agentic-awesome-skills47k1 repos~3.8kAutomated safety check: PassApache-2.0
Refactor Method Complexity Reducegithub/awesome-copilot40k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Build an Opportunity Solution Tree (OST) to structure product discovery — map a desired outcome to opportunities, solutions, and experiments.

    27k GitHub stars~1.1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Official

    Interactively discovers requirements and designs holistic, multi-product system architectures, solution blueprints, and deployment recommendations for complex workloads on Google Cloud.

    21k GitHub stars~3.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • D365 Solution Blueprint

    github/awesome-copilot

    Official

    Authors a Dynamics 365 Finance and Supply Chain Management Solution Blueprint from scratch through a structured, section-by-section architect interview, establishing scope, target operating model…

    40k GitHub stars~2.7k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Complexity Cuts

    sickn33/agentic-awesome-skills

    Lower Big-O on existing code via a one-transformation-at-a-time playbook with verify-revert-stop.

    47k GitHub starsUsed in 1 repo~3.8k tokens
    DatabasesAuto-check passed
  • Refactor Method Complexity Reduce

    github/awesome-copilot

    Official

    Refactor given method ${input:methodName} to reduce its cognitive complexity to ${input:complexityThreshold} or below, by extracting helper methods.

    40k GitHub starsUsed in 1 repo~1.1k tokens
    DevelopmentAuto-check passed
  • Elegance

    srid/emanote

    Iteratively study and apply elegant coding patterns. An agent skill from srid/emanote.

    963 GitHub stars~602 tokensUpdated 2 mo ago
    DevelopmentAuto-check passed

More from human-avatar/skills-for-humanity

All 11 skills in this repo
  • S4H Reasoning Orchestrator

    human-avatar/skills-for-humanity

    Takes a situation described in plain English, designs a short sequence of reasoning skills for it and runs them in order, each building on the last.

    231 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Ethics Council

    human-avatar/skills-for-humanity

    Runs a decision or policy question past five ethical frameworks, has them review one another, and returns a chair's synthesis of which values conflict.

    231 GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed
  • S4h Logic Council

    human-avatar/skills-for-humanity

    Run a reasoning problem, argument, plan, or decision through a council of 5 logical reasoning advisors who analyze it from distinct reasoning frameworks, peer-review each other, and synthesize a…

    231 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • S4h Aesthetic

    human-avatar/skills-for-humanity

    Entry point for the aesthetic toolkit. An agent skill from human-avatar/skills-for-humanity.

    231 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • S4h Aesthetic Coherence Check

    human-avatar/skills-for-humanity

    Tests whether the parts of something form a unified whole — finding the jarring inconsistencies that accumulate when different contributors work without a shared vision.

    231 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • S4h Aesthetic Pattern Detection

    human-avatar/skills-for-humanity

    Identifies the underlying formal pattern at work — because most successful designs, arguments, and solutions share deep structural patterns, and naming the pattern unlocks the playbook.

    231 GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed

Questions about S4h Aesthetic Elegance Testing

What does S4h Aesthetic Elegance Testing do?

Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time. S4h Aesthetic Elegance Testing is an agent skill from human-avatar/skills-for-humanity. Tests whether a solution is more complex than it needs to be — distinguishing necessary complexity from accidental complexity that accreted over time.

How do I install S4h Aesthetic Elegance Testing in Claude Code?

Run `npx skills add human-avatar/skills-for-humanity --skill s4h-aesthetic-elegance-testing -a claude-code`. Or copy the skill folder (skills/s4h-aesthetic-elegance-testing in human-avatar/skills-for-humanity) into .claude/skills/s4h-aesthetic-elegance-testing in your project. Claude Code loads it when a task matches its description.

How do I install S4h Aesthetic Elegance Testing in Codex?

Run `npx skills add human-avatar/skills-for-humanity --skill s4h-aesthetic-elegance-testing -a codex`. Or copy the skill folder (skills/s4h-aesthetic-elegance-testing in human-avatar/skills-for-humanity) into .agents/skills/s4h-aesthetic-elegance-testing in your project. Codex loads it when a task matches its description.

Can I use S4h Aesthetic Elegance Testing 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 human-avatar/skills-for-humanity --skill s4h-aesthetic-elegance-testing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/s4h-aesthetic-elegance-testing, .gemini/skills/s4h-aesthetic-elegance-testing, .github/skills/s4h-aesthetic-elegance-testing and .opencode/skills/s4h-aesthetic-elegance-testing in your project.

What does S4h Aesthetic Elegance Testing need to run?

SKILL.md names no scripts, command-line tools or credentials: S4h Aesthetic Elegance Testing is instructions for the agent only.

Does S4h Aesthetic Elegance Testing 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 S4h Aesthetic Elegance Testing 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 S4h Aesthetic Elegance Testing use?

S4h Aesthetic Elegance Testing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does S4h Aesthetic Elegance Testing use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to S4h Aesthetic Elegance Testing?

Skills that share tags, products or a category with S4h Aesthetic Elegance Testing: Opportunity Solution Tree (phuryn/pm-skills, 27k stars), Google Cloud Solution Architecture (google/skills, 21k stars), D365 Solution Blueprint (github/awesome-copilot, 40k stars) and Complexity Cuts (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains S4h Aesthetic Elegance Testing?

human-avatar (a GitHub organization) maintains it in human-avatar/skills-for-humanity, which has 231 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on July 15, 2026.

Source: human-avatar/skills-for-humanity on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.