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.

201 stars 12 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add swyxio/skills --skill keep-it-simple
Manual install
git 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-simple

Personal 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,
Read the full skill on GitHub

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

201

swyxio/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.

Software Development12

Accelevents Speaker Sync

201

swyxio/skills

Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.

AI, LLMs & Agents12

Agents SDK

201

swyxio/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.

AI, LLMs & Agents12

Knip Deadcode

228

pproenca/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.

Software Development19

Jscodeshift

228

pproenca/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.

Software Development19

Language Evolution

191

jwynia/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.

Software Development24

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.