About simplicity
Simplicity is a design skill for reducing complexity in architectures, APIs, workflows, and long-lived interfaces. It guides practitioners to preserve required properties while favoring direct designs and removing unnecessary abstractions.
Key features
- 01Separate requirements from preferences
- 02Inspect existing mechanisms first
- 03Prefer direct designs with clear boundaries
- 04Remove complexity that no longer helps
Use cases
- 01Simplify an existing architecture
- 02Review an API design
- 03Reduce workflow complexity
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/simplicityin Claude Code to confirm it loaded.
Bundled filesagents/openai.yamlreferences/guide.md
Details
From the project READMESimplicity
Spend complexity only where it buys a required property. Keep the real problem, constraints, and failure cost visible, then choose the smallest design that satisfies them.
- Separate the required result from preferences and future options.
- Inspect existing mechanisms before adding abstractions or dependencies.
- Prefer a direct design with a clear boundary and local proof.
- Remove complexity that no longer earns its cost.
Read the detailed guide when simplifying an architecture, API, workflow, or long-lived interface.
Comments
Markdown supported