Intent Clarity Audit

What This Skill Does

Audits source code for patterns that make it harder to understand what the code is doing and why. Focuses on five categories of intent obscurity:

1. Unclear names: Single-letter variables outside tiny loops, generic names (data, temp, result, val, info, item) in non-trivial scopes, abbreviated names that sacrifice readability.
2. Nested ternaries: Ternary or conditional expressions nested two or more levels deep.
3. Unnamed boolean parameters: Function calls passing bare true/false literals without a named parameter, comment, or object wrapper to explain the meaning.
4. Overly clever one-liners: Dense expressions that chain multiple operations, bitwise tricks used for non-bitwise purposes, regex used inline without explanation, or reduce/fold with complex accumulators.
5. Restating comments: Comments that describe what the next line does rather