do-oop-auditlisted
Install: claude install-skill tomcounsell/ai
# OOP / Data Modeling Audit
Scans Python class definitions for 14 structural anti-patterns covering field semantics, object boundaries, inheritance design, naming consistency, and coupling. Framework-agnostic: works with Django, SQLAlchemy, Pydantic, dataclasses, and vanilla Python. Produces a severity-grouped findings report and pauses for human review.
## What this skill does
1. Scans the target path for all `.py` files containing class definitions
2. Runs 14 semantic checks against each class and its relationships
3. Produces a structured findings report organized by severity (CRITICAL, WARNING, INFO)
4. Pauses for discussion — no auto-fix, findings only
## Invocation
```
/do-oop-audit [path] [--framework django|sqlalchemy|pydantic|auto] [--severity critical|warning|info]
```
- `path`: Directory or file to audit. Defaults to current project root.
- `--framework`: Force a framework context. Default is `auto` (detect from imports and base classes).
- `--severity`: Minimum severity to include in the report. Default: show all.
## Quick start
1. **Enumerate**: Find all `.py` files in the target path containing `class ` definitions
2. **Detect framework**: Identify Django / SQLAlchemy / Pydantic / dataclasses / vanilla (see Framework Detection below)
3. **Check**: Run each of the 14 audit checks against every class and cross-class relationship
4. **Filter**: If `--severity` is set, exclude findings below the threshold
5. **Report**: Present findings grouped by severity
6