kiss-principle — Claude Code skill: simplify code and install
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.
no license 251 installs ★ 25 updated 2026-02-19
npx skills add markpitt/claude-skills --skill kiss-principle -a claude-codeWhat kiss-principle 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.
What it helps with
- 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 for the agent
- 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.
How to install kiss-principle
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill kiss-principle -a claude-code2Manually: put the files in place
~/.claude/skills/kiss-principle/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/kiss-principle/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill kiss-principle -a codex2Manually: put the files in place
.agents/skills/kiss-principle/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill kiss-principle -a cursor2Manually: put the files in place
.cursor/skills/kiss-principle/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install markpitt/claude-skills skills/kiss-principle2Manually: put the files in place
.github/skills/kiss-principle/SKILL.md1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill kiss-principle -a gemini-cli2Platform CLI
gemini skills install https://github.com/markpitt/claude-skills --path skills/kiss-principleManually: put the files in place
.devin/skills/kiss-principle/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill kiss-principle -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about kiss-principle
How do I install kiss-principle in Claude Code?
Run npx skills add markpitt/claude-skills --skill kiss-principle -a claude-code. The skill file is at ~/.claude/skills/kiss-principle/SKILL.md.
What does kiss-principle do?
It guides the agent through examining complexity in code or design, selecting ways to reduce it, and checking that the solution still meets its requirements.
How does kiss-principle approach refactoring?
It recommends simplifying one layer at a time and checking behavior after each change.