Agent skill · software engineering · aiskillstore
code-analysis
Check if code is readable by non-developers - clear names, plain English comments, no jargon
Why this skill is useful
Codifies a standard for code readability that the AI could infer but now doesn't have to guess.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Code Readability Checker Analyzes code to ensure non-developers (managers, stakeholders, new team members) can understand it. What It Checks Clear naming: No cryptic abbreviations (usrtkn → userToken) Plain comments: Everyday language, not technical jargon Documentation: What/Why/How for major sections Comment ratio: At least 20% of lines should be comments Usage Example Bad Code (score: 71/100): Issues: Cryptic names, no comments, unclear purpose. Good Code (score: 95/100): Known Issues May flag false positives in documentation files Works best on actual production code Use --strictness lenient to reduce noise
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/code-analysis