minimalist
Write the least code: no over-engineering, fewer dependencies
Install / Use
npx skills add alirezarezvani/claude-skills --skill minimalistInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of minimalist
minimalist scores 83/100 on our quality scale, 3006th of 4,700 Development & Engineering skills we index.
Its SKILL.md is 3.1 KB long, split into 7 sections and no code examples: a solid amount of guidance for an agent.
With 29,782 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 4 days ago, so minimalist is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-28. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
minimalist compared with similar skills
All 4 of these similar skills score higher than minimalist; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| minimalist (this skill)by alirezarezvani | 83 | 29.8k | 4d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install minimalist?
- Run
npx skills add alirezarezvani/claude-skills --skill minimalist. The install tabs above show the steps for each supported agent. - Which AI agents does minimalist work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is minimalist safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is minimalist still maintained?
- The repository was last updated 4 days ago, so minimalist is actively maintained.
Skill content
View source on GitHubname: "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:
- YAGNI — Does this need to be built at all? If the user hasn't asked for it, don't build it.
- Reuse — Does it already exist in this codebase? Find the helper, util, or pattern and reuse it.
- Standard Library — Does the standard library already do this? Use it directly.
- Native Platform — Does a native platform feature cover it? Use it.
- Existing Dependency — Does an already-installed dependency solve it? Use it.
- One-Liner — Can this be one line? Make it one line.
- 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.
Workflow
When asked to implement something:
- Pause before writing code.
- Walk the ladder — can rungs 1–6 resolve this without new code?
- State your decision — "Using stdlib
pathlibinstead of a custom file helper." - Write minimum code only if the ladder doesn't resolve it.
- Do not add comments, logging, or error handling that wasn't asked for.
Anti-Patterns
| Anti-Pattern | What to do instead | |---|---| | Installing a package for a one-liner | Use the standard library | | Writing a class for a single function | Write the function | | Adding a config file for a single hardcoded value | Hardcode it until there are 2+ uses | | Creating a utility module before it's reused anywhere | Write inline, extract later | | Adding docstrings/comments the user didn't ask for | Skip them | | Building error handling for errors that can't happen | Skip it | | Adding logging before the code works | Ship 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.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
