# Code Analysis

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

- Skill: `aiskillstore/code-analysis` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aiskillstore/code-analysis`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiskillstore/code-analysis/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aiskillstore (https://skillmd.com/u/aiskillstore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/aiskillstore/code-analysis

---


# 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

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

## Example

**Bad Code** (score: 71/100):
```python
def proc(usr, tkn):
    tmp = usr + tkn
    return tmp * 2
```

Issues: Cryptic names, no comments, unclear purpose.

**Good Code** (score: 95/100):
```python
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