# Validate Python Docstrings Against Function Signatures with pydoclint

> Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.

- Skill: `agentskillexchange/validate-python-docstrings-against-function-signatures-with-` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/validate-python-docstrings-against-function-signatures-with-`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/validate-python-docstrings-against-function-signatures-with-/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/validate-python-docstrings-against-function-signatures-with-

---


# Validate Python Docstrings Against Function Signatures with pydoclint

Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.

## Prerequisites

Python, pydoclint, Python source tree

## Installation

Use the upstream install or setup path that matches your environment:
- pip install pydoclint
- pip install pydoclint[flake8]

Requirements and caveats from upstream:
- _Pydoclint_ is a Python docstring linter to check whether a docstring's
- Here is a comparison of linting time on some famous Python projects:
- also install _flake8_ to the current Python environment:

Basic usage or getting-started notes:
- [Google](https://www.sphinx-doc.org/en/master/usage/extensions/example_google.html),
- [2. Usage](#2-usage)
- To install only the native _pydoclint_ tooling, run this command:

- Source: https://github.com/jsh9/pydoclint
- Extracted from upstream docs: https://raw.githubusercontent.com/jsh9/pydoclint/HEAD/README.md

## Documentation

- https://jsh9.github.io/pydoclint/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/validate-python-docstrings-against-function-signatures-with-pydoclint/)