---
title: "Validate Python Docstrings Against Function Signatures with pydoclint"
description: "Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves."
verification: "listed"
source: "https://github.com/jsh9/pydoclint"
author: "jsh9"
publisher_type: "individual"
category:
  - "Code Quality & Review"
framework:
  - "Multi-Framework"
tool_ecosystem:
  github_repo: "jsh9/pydoclint"
  github_stars: 208
---

# 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

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install with pip, then run it over the package or changed files you want to verify: pip install pydoclint && pydoclint path/to/package
```

## Documentation

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

## Source

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