Guillempuche Ai Agent Readability Improver
guillempuche-ai-agent-readability-improver is a Claude Code plugin for the Ship phase that runs a selective agent to improve naming, comments, and whitespace after complex logic is written.
by guillempuche · github.com/guillempuche/ai-agent-readability-improver
Run a selective Claude Code agent after dense logic lands to tighten names, comments, and whitespace without noisy refactors.
Add it to Claude Code
Install the plugin in Claude Code. One command, paste-ready.
/plugin install guillempuche-ai-agent-readability-improver@guillempuche/ai-agent-readability-improverBuilt to be called by your agent
Skillselion is itself an MCP server. Your agent can pull this entry and a paste-ready install config straight from the API - no copy-paste.
Retrieve this entry with skillselion.get_details("plugin:guillempuche/ai-agent-readability-improver") and the paste-ready config with skillselion.get_install_config("plugin:guillempuche/ai-agent-readability-improver").
What it does
guillempuche-ai-agent-readability-improver is a Claude Code plugin that registers an agent focused on code readability: thoughtful renaming, targeted comments, and whitespace cleanup. Solo builders ship fast with AI and often end up with correct but opaque logic; this plugin is for the moment after that burst, when you want the next you—or the next agent—to understand the code without a full rewrite. The agent is intentionally selective: it improves clarity where ambiguity hurts maintenance and leaves already-clear sections alone, which keeps diffs small and review-friendly. It fits indie workflows where you do not have a dedicated style reviewer but still care about maintainability before you merge or hand off. Install it when you routinely produce complex branches and want a repeatable readability ritual in the ship phase rather than ad-hoc “please clean this up” prompts.
Highlights
- Selective renames, comments, and whitespace—skips files that already read clearly
- Invoked after complex logic or when diffs need a human-readable pass
- Single-plugin bundle from guillempuche/ai-agent-readability-improver
- Pairs with agent-driven ship workflows in Claude Code
- Lightweight editorial pass, not a full linter or security audit
Why builders use it
Agent-generated code often works but reads like a maze, so every follow-up change costs extra tokens and risk.
After install, you can invoke a readability-focused agent that tightens clarity in place so review and future edits move faster.
At a glance
- Type - Plugin in Development Tools.
- Adoption - 0 installs, 0 stars, 0 votes.
FAQ
Who is guillempuche-ai-agent-readability-improver for?
Indie and solo developers using Claude Code who write or accept AI-assisted code and want selective readability improvements without a full rewrite.
When should I use guillempuche-ai-agent-readability-improver?
Use it after you finish complex logic or when a file would benefit from clearer names, comments, or layout—typically during ship and review, not at project kickoff.
How do I add guillempuche-ai-agent-readability-improver to my agent?
Add the guillempuche/ai-agent-readability-improver plugin to Claude Code from the Skillselion catalog, enable it in your project, then invoke the readability agent on the paths you want clarified.
Comments
Share how you use guillempuche-ai-agent-readability-improver, gotchas, or tips for other indie builders.
No comments yet - be the first to share how you use it.