When does the Readability Review skill trigger?

It activates automatically when Claude detects keywords like 'naming,' 'complexity,' 'nesting,' or 'readability' during a code review session.

What tools does this skill utilize?

It leverages standard filesystem tools like Read, Grep, Glob, and Task to analyze your codebase and suggest specific structural improvements.

Can this skill help with AI-generated code quality?

Yes, it specifically detects 'AI anti-patterns' such as unnecessary classes, premature abstractions, and over-engineering often found in AI-written snippets.

Does it support non-English development environments?

The skill includes comprehensive support for Japanese terminology and triggers, making it highly effective for localized or bilingual teams.

How does Miller's Law apply to coding?

Miller's Law suggests humans can process 7±2 items at once. This skill flags functions, arguments, or branches that exceed these limits to reduce developer fatigue.

Readability Reviewer

Name: Readability Reviewer
Author: thkt

bythkt

•

협업 도구

Optimizes code clarity and reduces cognitive load by applying Readable Code principles and Miller's Law.

소개

The Readability Reviewer skill empowers Claude to perform deep code quality audits centered on cognitive science and the philosophy of 'The Art of Readable Code.' By implementing Miller's Law (the 7±2 rule), it identifies sections where complexity exceeds human processing limits, leading to higher error rates. The skill provides specific, actionable guidance on naming conventions, reducing nesting through guard clauses, and improving comment strategies. It also features a unique detection layer for AI-generated anti-patterns, preventing premature abstraction and over-engineering in modern development workflows.

주요 기능

Naming strategy audits for variables, functions, and classes
3 GitHub stars
Control flow optimization through nesting reduction and guard clauses
Cognitive load analysis based on Miller’s Law (7±2 items)
AI-specific anti-pattern detection to prevent over-engineering
Context-aware comment analysis focusing on 'Why' rather than 'What'

사용 사례

Refactoring complex legacy functions with deep nesting and confusing logic
Automating code reviews to enforce team-wide readability and naming standards
Simplifying AI-generated code snippets to ensure they are maintainable and not over-abstracted

소개

주요 기능

Naming strategy audits for variables, functions, and classes
3 GitHub stars
Control flow optimization through nesting reduction and guard clauses
Cognitive load analysis based on Miller’s Law (7±2 items)
AI-specific anti-pattern detection to prevent over-engineering
Context-aware comment analysis focusing on 'Why' rather than 'What'

사용 사례

Refactoring complex legacy functions with deep nesting and confusing logic
Automating code reviews to enforce team-wide readability and naming standards
Simplifying AI-generated code snippets to ensure they are maintainable and not over-abstracted