readability-review
CommunityBoost code readability at review time.
Software Engineering#refactoring#readability#maintainability#code-review#diff-analysis#cognitive-complexity
Authorclaushaas
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill helps teams assess and improve code readability and maintainability during reviews, surfacing cognitive complexity, hidden coupling, and maintenance risks to guide safer changes.
Core Features & Use Cases
- Readability-focused reviews to identify cognitive load, unclear naming, and long or nested methods.
- Maintainability guidance to suggest refactoring opportunities, clearer interfaces, and better documentation.
- Use Case: Apply during pull requests, large diffs, or changes in critical areas to ensure code remains understandable and safe to modify.
Quick Start
Run readability-review on a PR diff or code change to surface readability and maintainability issues. Example: readability-review --diff <diff-file> or provide the diff to the skill for analysis.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: readability-review Download link: https://github.com/claushaas/claus-haas-ai-stuff/archive/main.zip#readability-review Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.