generate-api-docs

Generates API reference documentation from Python docstrings using pdoc or Sphinx.

18|5|Updated Nov 3, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill generate-api-docs-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-api-docs
Source: https://github.com/HomericIntelligence/ProjectOdyssey/tree/main/.claude/skills/tier-2/generate-api-docs
Command: npx skills add https://github.com/HomericIntelligence/ProjectOdyssey --skill generate-api-docs-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of API reference documentation by extracting information directly from code docstrings, ensuring consistency and reducing manual documentation effort.

Core Features & Use Cases

  • Automated Documentation Generation: Creates HTML or Markdown API references from source code.
  • Docstring Extraction: Parses function signatures, parameters, return types, and exceptions.
  • Use Case: When releasing a new Python library, use this Skill to automatically generate a comprehensive API reference guide that developers can easily navigate.

Quick Start

Use the generate-api-docs skill to create HTML documentation for the 'my_module' Python package.

Frequently Asked Questions about generate-api-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API documentation from Python docstrings?

To generate API documentation from Python docstrings, this Skill parses function signatures, parameters, return types, and exceptions to automatically create HTML or Markdown reference guides for software libraries.

What docstring formats are supported for generating API reference documentation?

Generating API reference documentation requires valid docstrings in Google, NumPy, or reStructuredText format to successfully extract module interfaces and create output standards for module overviews and cross-references.

Can I use Sphinx or pdoc to create HTML API references from source code?

Yes, you can create HTML API references from source code using Sphinx or pdoc. This Skill leverages these tools to automate documentation generation by extracting information directly from your code's docstrings.

Does generating API docs with this approach work for public module interfaces?

Generating API docs with this approach works specifically for documenting public module interfaces. It applies to creating reference guides for software libraries by adhering to output standards for module overviews and cross-references.

What is the best way to automate Python library documentation for a new release?

The best way to automate Python library documentation is using this Skill to extract docstrings and generate a comprehensive API reference guide. This ensures consistency and reduces manual documentation effort when releasing a new library.