Skip to content

About

elevates code, tests, and prose to artful simplicity.

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Repository files navigation

Artful Simplicity

A read-only plugin for auditing code, tests, and prose for readability, over-engineering, redundancy, and misplaced concerns. It asks whether a cold reader can name each unit's one idea and recommends the safer direction: delete, fold, move, or rewrite.

Plugin installation

Claude Code:

claude plugin marketplace add transparent-pegasus/artful-simplicity
claude plugin install artful-simplicity@artful-simplicity

Codex:

codex plugin marketplace add transparent-pegasus/artful-simplicity
codex plugin add artful-simplicity@artful-simplicity

Cursor:

agent plugin marketplace add https://github.com/transparent-pegasus/artful-simplicity.git

Then install Artful Simplicity from Cursor's plugin marketplace. Start a new agent session after installation.

OpenCode 2 (tested with 2.0.32):

opencode plugin add artful-simplicity@git+https://github.com/transparent-pegasus/artful-simplicity.git

Start a new OpenCode session after installation. The plugin registers the bundled artful-simplicity skill. OpenCode 1.18.29 and later V1 releases are also supported through the legacy plugin entrypoint.

For a local checkout, run npm install in this repository, then add the repository directory to plugins in your project's opencode.json:

{
  "plugins": ["/absolute/path/to/artful-simplicity"]
}

Use the directory path, as OpenCode 2 does not load individual plugin files from plugins configuration entries.

AUDIT.md

AUDIT.md is the prompt for auditing the Artful Simplicity skill itself.

Follow AUDIT.md to audit skills/artful-simplicity/SKILL.md.

About

elevates code, tests, and prose to artful simplicity.

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Contributors

Languages