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.