Python Documentation Generator

Python Documentation Generator

Generate comprehensive markdown documentation from Python source code.

When to Use This Skill

• User asks to "document this code" or "generate docs"
• Creating API documentation from Python modules
• Generating README files with usage examples
• Extracting docstrings and type signatures into readable format
• User mentions "documentation", "docstrings", or "API reference"

Input

Accept either:

• Single Python file path
• Directory path (recursively process .py files)
• List of specific files

Output Format

Generate standard markdown with:

# Module Name

Brief description from module docstring.

## Classes

### ClassName

Description from class docstring.

**Methods:**
- `method_name(param: type) -> return_type`: Brief description

## Functions

### function_name(param: type) -> return_type