# Keep It Simple

> Use when implementing a feature or fix and tempted to add abstraction, configuration, options, or flexibility beyond what was actually asked for. Makes the agent write the minimum code that solves the real problem, instead of speculative complexity built for imagined future needs.

- **Type:** Skill
- **Install:** `agentstack add skill-buildmoonshot-skillpacks-keep-it-simple`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [buildmoonshot](https://agentstack.voostack.com/s/buildmoonshot)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [buildmoonshot](https://github.com/buildmoonshot)
- **Source:** https://github.com/buildmoonshot/skillpacks/tree/main/skills/engineering/intermediate/keep-it-simple

## Install

```sh
agentstack add skill-buildmoonshot-skillpacks-keep-it-simple
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Keep It Simple

Write the **minimum code that solves the actual problem.** Speculative complexity is a cost you pay now for a future that usually never arrives.

## Defaults

- **Don't build for requirements you don't have.** No config options, plugin systems, or "flexibility" nobody asked for. Solve today's problem; generalize later *if* a second case actually shows up.
- **No abstraction for single use.** Don't extract an interface, a base class, or a factory for something used once. Two concrete cases earn an abstraction; one does not.
- **Don't handle impossible cases.** Validate real inputs; don't write error handling for states that can't occur in this code path.
- **Prefer the boring solution.** A plain function beats a clever pattern when both work. Clever is a tax every future reader pays.

## The test

Before adding a layer, ask:

> Would a senior engineer look at this and say it's *overcomplicated*?

If yes, delete the cleverness and write the direct version.

## When complexity IS warranted

Real, present requirements justify real structure — genuine duplication, a known second use case, an actual extensibility need someone asked for. The rule isn't "never abstract." It's "don't abstract *speculatively*." Earn each layer with a concrete reason.

## Why this matters

Every speculative abstraction is code to read, test, debug, and maintain — in exchange for flexibility you may never use. The simplest version that works is almost always the right one, and it's far easier to add structure later than to remove it.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [buildmoonshot](https://github.com/buildmoonshot)
- **Source:** [buildmoonshot/skillpacks](https://github.com/buildmoonshot/skillpacks)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-buildmoonshot-skillpacks-keep-it-simple
- Seller: https://agentstack.voostack.com/s/buildmoonshot
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.