What problem does it solve?
This skill helps identify vague, misleading, inconsistent, or overly context-dependent names and exposes code whose behavior is difficult for a first-time reader to understand.
Core Features & Use Cases
- Isolation Test: Evaluates whether names communicate an entity's meaning without surrounding context.
- Scope-Length Review: Checks that name precision increases appropriately with scope and distance from use sites.
- Consistency and Obviousness Audit: Detects semantic splits, hard-to-name abstractions, and violated reader expectations in interfaces and implementations.
- Use Case: Apply it during a code review when variables such as data, process, or result obscure their roles, or when a method requires reading distant implementation details to understand its behavior.
Quick Start
Use the naming-obviousness skill to review the specified file or module for precise names, consistent terminology, and non-obvious behavior.