Keep It Simple
Review a diff, design, execution path, or subsystem for unnecessary complexity and propose concrete simplifications. Use during code review or independently when the user is concerned about overengineering, excessive coordination, or code that has become hard to understand or operate.
Install
npx skills add swyxio/skills --skill keep-it-simplegit clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/keep-it-simple ~/.claude/skills/keep-it-simplePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Keep It Simple Find the simplest implementation that meets the actual requirements. Ask what concrete requirement justifies each additional mechanism. Simplicity includes runtime behavior and operational burden, not just source length. ## Review the requested surface Establish the intended behavior, explicit constraints, and demonstrated failure modes. Distinguish these from hypothetical future needs and conventions inherited from templates or other skills. Inspect the relevant callers and execution path; do not turn a focused review into a repository cleanup. Trace what a reader must understand and what the system must execute. Look for: - duplicate state, validation, projections, or sources of truth; - pass-through layers, speculative interfaces, and configuration with no real use; - repeated remote calls, per-item bookkeeping, and unnecessarily small work units; - independent operations serialized without a correctness reason; - optional work coupled to user-visible completion or the critical path; - fallback, compatibility, and recovery machinery without a named consumer or demonstrated failure it addresses. Treat file size, module count, and test count as clues rather than targets. A cohesive large function can be simpler than several indirections. More batching code can make the overall execution simpler and cheaper. ## Propose fewer mechanisms For each useful finding, name the concrete cost and offer a specific deletion,
Details
- Skill name
keep-it-simple- Repository
- swyxio/skills
- Path
keep-it-simple/SKILL.md- License
- MIT
- Repo updated
- 16 November 2026
FAQ
What does the Keep It Simple skill do?
Review a diff, design, execution path, or subsystem for unnecessary complexity and propose concrete simplifications. Use during code review or independently when the user is concerned about overengineering, excessive coordination, or code that has become hard to understand or operate.
How do I install the Keep It Simple skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill keep-it-simple. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Keep It Simple popular?
It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.
Related skills
Accelevents API
201swyxio/skills
Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.
Accelevents Speaker Sync
201swyxio/skills
Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.
Agents SDK
201swyxio/skills
Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.
Knip Deadcode
228pproenca/dot-skills
Knip dead code detection best practices for JavaScript and TypeScript projects. Use when configuring Knip, analyzing unused code, setting up CI integration, or cleaning up codebases. Triggers on knip.json, dead code, unused exports, unused dependencies, bundle optimization.
Jscodeshift
228pproenca/dot-skills
jscodeshift codemod development best practices from Facebook/Meta. This skill should be used when writing, reviewing, or debugging jscodeshift codemods. Triggers on tasks involving AST transformation, code migration, automated refactoring, or codemod development.
Language Evolution
191jwynia/agent-skills
Design evolving language systems for fictional worlds. Use when creating language families, dialects, linguistic history, or when language should reflect cultural and historical development.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.