# Artful Simplicity

> Audit code, tests, and prose for artful simplicity; use for readability, design, refactoring, over-engineering, and redundancy reviews.

- Skill: `transparent-pegasus/artful-simplicity` (Agent Skill)
- Install (CLI): `npx skillmds@latest add transparent-pegasus/artful-simplicity`
- Raw SKILL.md: https://api.skillmd.com/api/skills/transparent-pegasus/artful-simplicity/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: transparent-pegasus (https://skillmd.com/u/transparent-pegasus)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/transparent-pegasus/artful-simplicity

---


# Artful simplicity

A unit is simple when a cold reader can name its one idea, predict its contents from its name, and keep nothing unrelated in mind. Tests state observable behavior and invariants; prose spends exactly the words it needs.

Local reading judges clarity, not necessity. Rewrite may follow from sight only if no observer sees behavior change; delete, fold, and move require, respectively, proof of reachability and consequence, equivalence across observable states and transitions, and independent agreement on the boundary. Seek contradictions, not volume.

Before changing behavior, name the change, the observer, the safety direction, and the broken alternative. Direction decides, not size.