Marketplace code-analysis

Check if code is readable by non-developers - clear names, plain English comments, no jargon

install

source · Clone the upstream repo

git clone https://github.com/aiskillstore/marketplace

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aiskillstore/marketplace "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/abejitsu/code-analysis" ~/.claude/skills/aiskillstore-marketplace-code-analysis && rm -rf "$T"

manifest: skills/abejitsu/code-analysis/SKILL.md

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 (usr_tkn → 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

python3 analyze.py --path your-file.py --strictness lenient

Example

Bad Code (score: 71/100):

def proc(usr, tkn):
    tmp = usr + tkn
    return tmp * 2

Issues: Cryptic names, no comments, unclear purpose.

Good Code (score: 95/100):

def process_user_authentication(username, auth_token):
    """Validate user credentials and return auth score"""
    combined_credential = username + auth_token
    return combined_credential * 2

Known Issues

May flag false positives in documentation files
Works best on actual production code
Use
```
--strictness lenient
```
to reduce noise