generate-docstrings

Generate structured docstrings for functions and classes in Google, NumPy, and reStructuredText formats.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually writing comprehensive and consistently formatted docstrings for functions and classes is a repetitive task that often gets overlooked, leading to undocumented code.

Core Features & Use Cases

  • Structured Docstring Creation: Helps write comprehensive docstrings following standard formats (Google, NumPy, reStructuredText).
  • API Documentation Support: Ensures docstrings contain all necessary information (parameters, returns, examples) for API documentation generation.
  • Use Case: When documenting a new public function, use this skill to generate a Google-style docstring template, prompting you to fill in parameters, return values, and usage examples.

Quick Start

Use the generate-docstrings skill to create a Google-style docstring for a Python matrix_multiply function, including args, returns, and an example.

Frequently Asked Questions about generate-docstrings

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

FAQPage Schema
How do I generate consistent docstrings for Python functions and classes?

Generate docstrings by using templates that follow standard formats like Google-style, NumPy-style, or reStructuredText. This Skill creates comprehensive docstrings with parameter descriptions, return types, exceptions, and usage examples to ensure API documentation consistency across your codebase.

What information should a docstring include for API documentation?

Docstrings for API documentation should include a one-line summary, parameter names and types, descriptions of each parameter, return value and type, raised exceptions, and practical usage examples. This Skill generates all these components in structured formats recognized by documentation generators.

Can I use this to standardize docstrings across different documentation formats?

Yes. This Skill supports multiple documentation formats—Google-style, NumPy-style, and reStructuredText—so you can generate consistently formatted docstrings regardless of which standard your project uses.

How do I apply docstring generation when updating existing code documentation?

When adding or updating code, use this Skill to generate docstring templates with all required sections pre-structured. This ensures new documentation follows your project's established format and includes all necessary API details without manual formatting.

Does this work with Mojo code as well as Python?

This Skill supports both Python and Mojo, generating appropriately formatted docstrings for functions and classes in either language following the same documentation standards.

What's the best way to handle repetitive docstring writing across a large codebase?

Use this Skill to automate docstring generation for multiple functions and classes at once, eliminating repetitive manual writing. Batch generation ensures consistent formatting and complete documentation coverage across your entire codebase.