Skip to content
Back to search

python-deps-doctor

Agent skill and script that audit Python dependencies: outdated pins and Python-version compatibility

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/arslan3x5--python-deps-doctor/badge.svg)](/listings/arslan3x5--python-deps-doctor)

HTML

<a href="/listings/arslan3x5--python-deps-doctor"><img src="/api/listings/arslan3x5--python-deps-doctor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 92 lines
  1. # Python Dependency Doctor
  2. An agent skill plus a small standalone script that audit a Python project's
  3. dependencies: which pins are outdated, and which ones will not install on your
  4. Python version.
  5. Pins rot quietly. `rembg==2.0.59`, for example, only supports Python 3.8 to 3.12,
  6. so it fails to install on Python 3.14. This tool finds problems like that before
  7. they stop you, and the skill teaches an AI coding agent how to fix them safely.
  8. ![Example report](docs/demo.png)
  9. ## What it checks
  10. - **incompatible:** the pinned version does not support your (or a target) Python version
  11. - **outdated:** a newer release exists on PyPI
  12. - **unpinned / range:** dependencies with no version rule, or only a range
  13. - **unknown:** PyPI could not be reached or does not know the package
  14. It also reads the UTF-16 requirements files that `pip freeze >` creates in
  15. Windows PowerShell.
  16. ## Example
  17. Checking an old `requirements.txt` against Python 3.14.3:
  18. ```
  19. ## requirements.txt (checked against Python 3.14.3)
  20. Summary: 1 incompatible, 4 outdated
  21. | Package | Rule | Status | Detail |
  22. | --- | --- | --- | --- |
  23. | rembg | ==2.0.59 | incompatible | rembg==2.0.59 requires Python <3.13,>=3.8, but this is Python 3.14.3 |
  24. | flask | ==3.0.3 | outdated | 3.0.3 -> 3.1.3 |
  25. | numpy | ==2.0.2 | outdated | 2.0.2 -> 2.5.5 |
  26. | pillow | ==11.0.0 | outdated | 11.0.0 -> 13.0.0 |
  27. | werkzeug | ==3.0.4 | outdated | 3.0.4 -> 3.1.9 |
  28. ```
  29. Versions come from PyPI on the day you run it.
  30. ## Use it as an agent skill
  31. Copy the `skills/python-deps-doctor` folder into your agent's skills folder
  32. (for Claude Code, that is `~/.claude/skills/`). Then ask your agent something
  33. like "audit my dependencies" or "pip install fails on Python 3.14, fix my
  34. requirements.txt". The skill tells the agent to run the script, read the
  35. report, upgrade in a fresh virtual environment, test, and report before and
  36. after.
  37. ## Use the script on its own
  38. ```
  39. python skills/python-deps-doctor/scripts/audit.py path/to/project
  40. python skills/python-deps-doctor/scripts/audit.py path/to/project --python 3.14.3
  41. ```
  42. It needs Python 3.8 or newer and the `packaging` library (installed with pip).
  43. Exit code 0 means nothing needs action, 1 means something is incompatible or
  44. outdated, 2 means no requirements file was found. That makes it usable in CI.
  45. ## Limits
  46. - Reads `requirements*.txt` only. `pyproject.toml` support is planned.
  47. - Does **not** check for security vulnerabilities. Use `pip-audit` or Dependabot
  48. for that. The skill tells the agent not to claim otherwise.
  49. - Checks the packages listed in the file, not their sub-dependencies.
  50. - Needs internet access to pypi.org.
  51. - Tested on Windows with Python 3.12. It has not yet been tested with every
  52. agent, so feedback is welcome.
  53. ## Development
  54. ```
  55. pip install pytest packaging
  56. python -m pytest
  57. ```
  58. The tests use fake PyPI responses, so they run without a network connection.
  59. ## Feedback
  60. Found a case it gets wrong? Open an issue and paste the report it printed.
  61. ## License
  62. MIT
  63. ## Notes
  64. Built with AI assistance. The code was reviewed and tested by the author.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.