What are the recommended nesting limits?

The skill targets an ideal nesting depth of 2, with a maximum strict limit of 3, encouraging the use of guard clauses and early returns to flatten logic.

What is Miller's Law in code review?

Miller's Law suggests humans can only hold 7±2 items in working memory. This skill applies that science to limit function arguments, class methods, and nesting depth to keep code manageable.

Can this skill detect AI-generated over-engineering?

Yes, it specifically identifies AI smells like premature abstractions, unnecessary interfaces for single implementations, and 'future-proof' flexibility that hasn't been requested.

How does it improve variable naming?

It audits names for concreteness and searchability, ensuring that a function's intent is obvious from its name (e.g., using 'validateUserEmail' instead of 'processData').

Code Readability Reviewer

Name: Code Readability Reviewer
Author: thkt

bythkt

•

보안 및 테스팅

Optimizes code clarity and minimizes cognitive load using Miller's Law and readable code principles.

Code Readability Reviewer transforms Claude into a sophisticated code auditor that prioritizes clarity and cognitive ergonomics. Grounded in 'The Art of Readable Code' and Miller's Law (7±2), it enforces strict limits on function length, nesting depth, and argument counts to ensure any team member can understand logic in under a minute. The skill specifically targets complex control flows, vague naming conventions, and common AI-generated anti-patterns like premature abstraction, resulting in a cleaner, more maintainable codebase that focuses on human readability over cleverness.

주요 기능

01Cognitive Load Analysis: Identifies and simplifies complex control flows and deep conditional branches.

02AI Anti-pattern Detection: Flags premature abstractions and unnecessary 'future-proof' code generated by AI.

033 GitHub stars

04Miller's Law Compliance: Enforces cognitive limits (7±2) for function arguments, methods, and nesting depths.

05Semantic Naming Audits: Replaces abstract names with concrete, searchable, and intent-revealing alternatives.

06Strategic Commenting: Focuses on explaining the 'why' behind implementation rather than the 'what'.

사용 사례

01Refactoring legacy code to improve team onboarding speed and maintainability.

02Automating code review feedback for pull requests based on cognitive load standards.

03Reviewing AI-generated code to remove unnecessary complexity and boilerplate abstractions.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thkt/claude-config reviewing-readability

For use in Claude.ai and ChatGPT

Download Skill