Agent skill

Minimalist

by alirezarezvani in alirezarezvani/claude-skills

A skill your agent uses when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions.

MITAuto-check passedDevelopment

Install Minimalist

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill minimalist -a claude-code

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

GitHub CLI
$ gh skill install alirezarezvani/claude-skills minimalist --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/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/minimalist .claude/skills/minimalist && 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
minimalist
GitHub stars
28k
Token cost
~804 tokens
SKILL.md length
425 words
Files
1
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions.

  • Works in 7 steps: YAGNI — Does this need to be built at… → Reuse — Does it already exist in this… → Standard Library — Does the standard… → …
  • The user asks to write code efficiently
  • SKILL.md covers Overview, The Efficiency Ladder, Rules of Engagement and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Minimalist is an agent skill from alirezarezvani/claude-skills. Use when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions. Enforces a strict efficiency ladder: YAGNI, reuse, stdlib, native platform, existing deps — before writing any new code.

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

It sits in Development, covering Code simplification. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • The user asks to write code efficiently
  • Avoid over-engineering
  • Reduce dependencies
  • Prevent unnecessary abstractions

Example prompts

  • “/minimalist”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. YAGNI — Does this need to be built at all? If the user hasn't asked for it, don't build it.
  2. Reuse — Does it already exist in this codebase? Find the helper, util, or pattern and reuse it.
  3. Standard Library — Does the standard library already do this? Use it directly.
  4. Native Platform — Does a native platform feature cover it? Use it.
  5. Existing Dependency — Does an already-installed dependency solve it? Use it.
  6. One-Liner — Can this be one line? Make it one line.
  7. Minimum Code — Only then, write the minimum code that works.

What it can do on your machine

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

Minimalist loads about 804 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 425 words of instructions outside code blocks.

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

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 alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 425 words, ~804 tokens.

Download SKILL.mdSave it as .claude/skills/minimalist/SKILL.md (or your agent's skills folder).
name
minimalist
description
Use when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions. Enforces a strict efficiency ladder: YAGNI, reuse, stdlib, native platform, existing deps — before writing any new code.

Minimalist

You are highly efficient. The best code is the code never written.

Overview

Use this skill whenever the goal is to solve a problem with the least code possible. It prevents common AI failure modes: inventing helper classes for single-use logic, installing packages for one-line operations, and producing boilerplate that the user will never need.

The Efficiency Ladder

Before writing any new code, stop at the first rung that holds:

  1. YAGNI — Does this need to be built at all? If the user hasn't asked for it, don't build it.
  2. Reuse — Does it already exist in this codebase? Find the helper, util, or pattern and reuse it.
  3. Standard Library — Does the standard library already do this? Use it directly.
  4. Native Platform — Does a native platform feature cover it? Use it.
  5. Existing Dependency — Does an already-installed dependency solve it? Use it.
  6. One-Liner — Can this be one line? Make it one line.
  7. Minimum Code — Only then, write the minimum code that works.

Rules of Engagement

  • No unrequested abstractions: Do not invent interfaces, base classes, or generics for future-proofing unless the user explicitly asks.
  • No unnecessary dependencies: If the standard library can do it cleanly, do not install a package.
  • No boilerplate: Deletion over addition. Boring over clever. Fewest files possible.
  • Question complex requests: Ask "Do you actually need X, or does Y cover it?" before building X.
  • Shortest working diff wins: But only once you understand the problem. The smallest change in the wrong place isn't lazy — it's a second bug.
Show full SKILL.md (169 more words)Show less

Workflow

When asked to implement something:

  1. Pause before writing code.
  2. Walk the ladder — can rungs 1–6 resolve this without new code?
  3. State your decision — "Using stdlib pathlib instead of a custom file helper."
  4. Write minimum code only if the ladder doesn't resolve it.
  5. Do not add comments, logging, or error handling that wasn't asked for.

Anti-Patterns

Anti-PatternWhat to do instead
Installing a package for a one-linerUse the standard library
Writing a class for a single functionWrite the function
Adding a config file for a single hardcoded valueHardcode it until there are 2+ uses
Creating a utility module before it's reused anywhereWrite inline, extract later
Adding docstrings/comments the user didn't ask forSkip them
Building error handling for errors that can't happenSkip it
Adding logging before the code worksShip the code first

Cross-References

  • Related: engineering/strict-api — prevents hallucinated APIs when writing minimal code; use together.
  • Related: engineering/zero-hallucination-coder — enforces verified-only API usage.
  • Related: engineering/karpathy-coder — Karpathy-inspired behavioral guidelines for LLM-assisted coding.

© alirezarezvani, 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 engineering/minimalist of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Minimalist 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.

Minimalist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minimalist this skillalirezarezvani/claude-skills28k—~804Automated safety check: PassMIT
PonytailDavidObando/gsharp5648 repos~1.7kAutomated safety check: PassMIT
Ponytail Reviewkortix-ai/suna20k4 repos~593Automated safety check: PassCustom licence
Ponytail Lazy Developer ModeDietrichGebert/ponytail159k—~873Automated safety check: PassMIT
Code Simplification for ego-litecitrolabs/ego-lite17k—~1.2kAutomated safety check: PassMIT
Refactor Pass for Simplicitystar-history/star-history9.6k1 repos~168Automated safety check: PassMIT

Similar skills

  • Ponytail

    DavidObando/gsharp

    Forces the laziest solution that actually works, simplest, shortest, most minimal.

    564 GitHub starsUsed in 8 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Ponytail Review

    kortix-ai/suna

    Code review focused exclusively on over-engineering. An agent skill from kortix-ai/suna.

    20k GitHub starsUsed in 4 repos~593 tokens
    DevelopmentAuto-check passed
  • Ponytail Lazy Developer Mode

    DietrichGebert/ponytail

    Makes the agent pick the laziest solution that works: skip unneeded work, reuse what exists, prefer the standard library and platform features, and keep diffs small.

    159k GitHub stars~873 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Finds and implements evidence-backed simplifications in the ego-lite repository, such as dead code, duplicated state and speculative abstractions, without hiding behavior changes.

    17k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Refactor Pass for Simplicity

    star-history/star-history

    Perform a refactor pass focused on simplicity after recent changes. Use when the user asks for a refactor/cleanup pass, simplification, or dead-code removal…

    9.6k GitHub starsUsed in 1 repo~168 tokens
    DevelopmentAuto-check passed
  • Reviews RTK's Rust code for over-engineering and verbose patterns, applying idioms like iterator chains and early returns while protecting a specific list of constraints from being simplified away.

    83k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Categories

Questions about Minimalist

What does Minimalist do?

A skill your agent uses when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions. Minimalist is an agent skill from alirezarezvani/claude-skills. Use when the user asks to write code efficiently, avoid over-engineering, reduce dependencies, or prevent unnecessary abstractions.

When should I use Minimalist?

Minimalist fits situations like: the user asks to write code efficiently; avoid over-engineering; reduce dependencies; prevent unnecessary abstractions.

How do I install Minimalist in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill minimalist -a claude-code`. Or copy the skill folder (engineering/minimalist in alirezarezvani/claude-skills) into .claude/skills/minimalist in your project. Claude Code loads it when a task matches its description.

How do I install Minimalist in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill minimalist -a codex`. Or copy the skill folder (engineering/minimalist in alirezarezvani/claude-skills) into .agents/skills/minimalist in your project. Codex loads it when a task matches its description.

Can I use Minimalist 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 alirezarezvani/claude-skills --skill minimalist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minimalist, .gemini/skills/minimalist, .github/skills/minimalist and .opencode/skills/minimalist in your project.

What does Minimalist need to run?

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

Does Minimalist 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 Minimalist 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 Minimalist use?

Minimalist 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 Minimalist use?

About 804 tokens (SKILL.md is roughly 3.2k 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 Minimalist?

Skills that share tags, products or a category with Minimalist: Ponytail (DavidObando/gsharp, 564 stars), Ponytail Review (kortix-ai/suna, 20k stars), Ponytail Lazy Developer Mode (DietrichGebert/ponytail, 159k stars) and Code Simplification for ego-lite (citrolabs/ego-lite, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minimalist?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,891 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

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