# kiss-principle

The kiss-principle skill helps spot needless complexity in code and design, then plan simpler solutions without dropping required behavior. Use it during reviews, refactors, or feature planning.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 251 installs · ★ 25 repo stars
- Author: markpitt
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/markpitt/claude-skills/tree/HEAD/skills/kiss-principle/SKILL.md
- Updated: 2026-02-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/kiss-principle

## What it does

The skill routes the task to relevant guidance: complexity analysis for reviewing existing work, design material for new features, and decision frameworks for technical choices. Its resources also cover simplification techniques, architecture, documentation, UX, and worked cases.

The workflow moves from identifying complexity to weighing tradeoffs, choosing an approach, and checking that the result still meets requirements. During a refactor, it recommends changing one layer at a time and validating after each change. Removing complexity without checking behavior can break something the project needs.

To install it in Claude Code, run the command in the FAQ. The skill file is at `~/.claude/skills/kiss-principle/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill kiss-principle -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/kiss-principle/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/kiss-principle/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill kiss-principle -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/kiss-principle/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill kiss-principle -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/kiss-principle/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install markpitt/claude-skills skills/kiss-principle
```

2. **Manually: put the files in place**
- File: `.github/skills/kiss-principle/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill kiss-principle -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/markpitt/claude-skills --path skills/kiss-principle
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/kiss-principle/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill kiss-principle -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/markpitt/claude-skills/tree/HEAD/skills/kiss-principle/SKILL.md

## When to use it
- spot unnecessary abstraction layers in code
- compare a simple solution with a more complex one
- plan a refactor with checks after each change
- design a feature without speculative scope
- identify what makes a component hard to maintain

## Example prompts
- Review this module for needless complexity and outline a simpler version.
- Help me design this feature while preserving its requirements and avoiding extra layers.
- Compare these two approaches and explain which one is easier to maintain.

## Similar
- [principle-fix-root-causes](https://affpapa.org/en/nevibecode/skills/principle-fix-root-causes.md) — skill · 10800 installs
- [principle-minimize-reader-load](https://affpapa.org/en/nevibecode/skills/principle-minimize-reader-load.md) — skill · 10200 installs
- [Clairvoyance](https://affpapa.org/en/nevibecode/mcp/clairvoyance.md) — MCP server · ★ 23 repo stars
- [kiss-cam](https://affpapa.org/en/nevibecode/skills/kiss-cam.md) — skill · 1700 installs
- [timing-principle-mastery](https://affpapa.org/en/nevibecode/skills/timing-principle-mastery.md) — skill · 596 installs
- [principle-the-algorithm](https://affpapa.org/en/nevibecode/skills/principle-the-algorithm.md) — skill · 135 installs

From the same set: [markpitt/claude-skills](https://affpapa.org/en/nevibecode/by/markpitt/claude-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
