What problem does it solve? Reading an entire Python codebase to understand its API surface wastes time and context. This Skill produces a compact structural overview of any Python module or package, replacing function bodies with ellipses so you can grasp signatures, classes, and docstrings at a glance. ## Core Features & Use Cases - AST-Based Stub Generation: Parses Python source with the ast module to emit imports, class definitions, method signatures, module-level assignments, and docstrings with bodies replaced by .... - Package-Wide Overviews: Processes entire directories, grouping files under # === path/file.py === headers with __init__.py listed first, plus source location comments for each definition. - Flexible Filtering: Flags like --no-docstrings and --no-private control output verbosity, and --output writes results to a file. - Use Case: When onboarding to an unfamiliar library, run the stub generator on its package directory to get a single-file summary of every public class and function signature before diving into implementation details. ## Quick Start Ask the AI to run stub_package.py on a target Python file or package directory to produce a condensed structural overview of its signatures and docstrings.
