← ClaudeAtlas

do-oop-auditlisted

Audit Python classes and OOP code for structural anti-patterns, naming inconsistencies, and data modeling issues. Use when reviewing class design, checking model health, validating object boundaries, or after refactoring. Also triggered by 'check my classes', 'review the data model', 'are there OOP problems', 'scan for design issues', 'lint class structure', 'audit models', 'validate OOP', or 'review object hierarchy'.
tomcounsell/ai · ★ 14 · AI & Automation · score 73
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