review-depth

What problem does it solve?

Review Python code for deep module design and progressive disclosure. Scores modules on interface-to-implementation ratio, cognitive load at each navigation level, and information hiding. Use this skill whenever the user says "simplify", "too complex", "hard to navigate", "cognitive load", "clean up interfaces", "deep modules", "progressive disclosure", "make it easier to understand", "reduce complexity", "hard to find things", or wants to enforce Ousterhout-style deep module principles. Do NOT trigger for general code review (use code-review), architecture scoring (use review-architecture), or refactoring execution (use refactor).

Core Features & Use Cases

Phase 1: Module Census to measure interface size and implementation depth for Python modules Phase 2: Progressive Disclosure Audit to map navigation levels and disclose violations Phase 3: Cognitive Load Scoring and Findings generation to quantify reader effort and produce actionable guidance

Quick Start

Run the skill on a Python project to generate a depth and disclosure report.