{"id":"32761126-3004-428c-95b4-559221cf3f99","shortId":"2HKunB","kind":"skill","title":"Validate Python Docstrings Against Function Signatures with pydoclint","tagline":"Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.","description":"# Validate Python Docstrings Against Function Signatures with pydoclint\n\nCheck that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves.\n\n## Prerequisites\n\nPython, pydoclint, Python source tree\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- pip install pydoclint\n- pip install pydoclint[flake8]\n\nRequirements and caveats from upstream:\n- _Pydoclint_ is a Python docstring linter to check whether a docstring's\n- Here is a comparison of linting time on some famous Python projects:\n- also install _flake8_ to the current Python environment:\n\nBasic usage or getting-started notes:\n- [Google](https://www.sphinx-doc.org/en/master/usage/extensions/example_google.html),\n- [2. Usage](#2-usage)\n- To install only the native _pydoclint_ tooling, run this command:\n\n- Source: https://github.com/jsh9/pydoclint\n- Extracted from upstream docs: https://raw.githubusercontent.com/jsh9/pydoclint/HEAD/README.md\n\n## Documentation\n\n- https://jsh9.github.io/pydoclint/\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/validate-python-docstrings-against-function-signatures-with-pydoclint/)","tags":["validate","python","docstrings","against","function","signatures","with","pydoclint","skills","agentskillexchange","agent-skills","ai-agents"],"capabilities":["skill","source-agentskillexchange","skill-validate-python-docstrings-against-function-signatures-with-pydoclint","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/validate-python-docstrings-against-function-signatures-with-pydoclint","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,188 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:13:01.309Z","embedding":null,"createdAt":"2026-05-18T13:20:12.178Z","updatedAt":"2026-05-18T19:13:01.309Z","lastSeenAt":"2026-05-18T19:13:01.309Z","tsv":"'/en/master/usage/extensions/example_google.html),':119 '/jsh9/pydoclint':137 '/jsh9/pydoclint/head/readme.md':144 '/pydoclint/':148 '/skills/validate-python-docstrings-against-function-signatures-with-pydoclint/)':155 '2':120,122 'agent':150 'agentskillexchange.com':154 'agentskillexchange.com/skills/validate-python-docstrings-against-function-signatures-with-pydoclint/)':153 'also':101 'basic':109 'caveat':74 'check':9,32,84 'code':22,45 'command':133 'comparison':92 'consist':14,37 'current':106 'doc':141 'docstr':3,12,26,35,81,87 'document':145 'environ':64,108 'evolv':23,46 'except':20,43 'exchang':152 'extract':138 'famous':98 'flake8':71,103 'function':5,28 'get':113 'getting-start':112 'github.com':136 'github.com/jsh9/pydoclint':135 'googl':116 'instal':53,57,66,69,102,125 'jsh9.github.io':147 'jsh9.github.io/pydoclint/':146 'lint':94 'linter':82 'match':62 'nativ':128 'note':115 'paramet':16,39 'path':60 'pip':65,68 'prerequisit':47 'project':100 'pydoclint':8,31,49,67,70,77,129 'python':2,11,25,34,48,50,80,99,107 'rais':19,42 'raw.githubusercontent.com':143 'raw.githubusercontent.com/jsh9/pydoclint/head/readme.md':142 'requir':72 'return':17,40 'run':131 'setup':59 'signatur':6,29 'skill':151 'skill-validate-python-docstrings-against-function-signatures-with-pydoclint' 'sourc':51,134,149 'source-agentskillexchange' 'start':114 'stay':13,36 'time':95 'tool':130 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'tree':52 'upstream':56,76,140 'usag':110,121,123 'use':54 'valid':1,24 'whether':85 'www.sphinx-doc.org':118 'www.sphinx-doc.org/en/master/usage/extensions/example_google.html),':117","prices":[{"id":"78fa35c7-1532-43bf-a2f6-25c0ccda0d5e","listingId":"32761126-3004-428c-95b4-559221cf3f99","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:20:12.178Z"}],"sources":[{"listingId":"32761126-3004-428c-95b4-559221cf3f99","source":"github","sourceId":"agentskillexchange/skills/validate-python-docstrings-against-function-signatures-with-pydoclint","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/validate-python-docstrings-against-function-signatures-with-pydoclint","isPrimary":false,"firstSeenAt":"2026-05-18T13:20:12.178Z","lastSeenAt":"2026-05-18T19:13:01.309Z"}],"details":{"listingId":"32761126-3004-428c-95b4-559221cf3f99","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"validate-python-docstrings-against-function-signatures-with-pydoclint","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"c1cddbb57d6cb1dd2333fdce9b8c14925bd0c37f","skill_md_path":"skills/validate-python-docstrings-against-function-signatures-with-pydoclint/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/validate-python-docstrings-against-function-signatures-with-pydoclint"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Validate Python Docstrings Against Function Signatures with pydoclint","description":"Check that Python docstrings stay consistent with parameters, returns, and raised exceptions as code evolves."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/validate-python-docstrings-against-function-signatures-with-pydoclint"},"updatedAt":"2026-05-18T19:13:01.309Z"}}