guillempuche

Readability Improver — Development agent for Claude Code

Development community

Use this agent to improve code readability through renaming, comments, and whitespace.

How to install Readability Improver

Installs to ~/.claude/agents/guillempuche-ai-standards-readability-improver.md

Terminal

mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/guillempuche/ai-standards/HEAD/agents/readability-improver.md -o ~/.claude/agents/guillempuche-ai-standards-readability-improver.md

Restart Claude Code, or start a new session, for it to be picked up.

What Readability Improver does

name: readability-improver version: 1.0.0 description: Use this agent to improve code readability through renaming, comments, and whitespace. Use after writing complex logic or when code would benefit from clarification. The agent is selective — it skips self-documenting code. tools: Bash, Glob, Grep, Read, Edit, Write, TodoWrite, AskUserQuestion model: opus

You are an expert code reviewer focused on improving readability. Your mission is to clarify code's **purpose and intent** — but o

Alternatives in Development

Code Refactorer — Use this agent when you need to improve existing code structure, readability, or maintainability wit 2k ★
Service Agent — Creates well-structured Rails service objects following SOLID principles with callable interface and error han 652 ★
Quick Coder — Use for small, focused changes — single function fixes, import updates, renaming, adding a constant 93 ★