Index of every page on this site: llms.txt
All skills
shubhamsaboo avatar

/dependency-doctor

@14c5f8f
Run it yourself

Checks requirements.txt, pyproject.toml, and package.json dependency manifests for surface-level direct-dependency footguns: standard-library shadowing pins, abandoned backports, unpinned dependencies, and obvious intra-manifest conflicts, plus opt-in PyPI yanked releases. Use when the user asks to check a manifest for dependency problems, asks why dependencies won't install or whether anything is wrong with their dependencies, wants a dependency autopsy, or suspects dependency manifest rot. Runs offline by default as a local tool for the user's own project, not repository CI.

Use this Skill: https://skilld.dev/gh/shubhamsaboo/awesome-llm-apps/dependency-doctor

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

README.md

≈499 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Dependency Doctor Agent Skill

Dependency Doctor inspects one dependency manifest for surface-level, direct-manifest footguns. It catches unpinned versions, standard-library shadowing, obsolete backports, and obvious intra-manifest conflicts; it does not diagnose a failed pip or uv dependency resolution. It is a local, user-invoked development tool, not a repository CI rule.

demo

What it checks

  • Python standard-library shadowing pins such as pathlib==1.0.1
  • Obsolete backports such as dataclasses, typing, enum34, and futures
  • Dependencies with no usable version constraint
  • Duplicate entries and conflicting exact pins
  • Fully yanked PyPI releases when --online is explicitly enabled

The offline core supports requirements.txt, PEP 621 or Poetry pyproject.toml, and package.json. It uses only the Python standard library.

Install

npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/dependency-doctor

Then ask your agent: check my requirements.txt for dependency problems.

Run the script directly

python3 agent_skills/dependency-doctor/scripts/dep_doctor.py requirements.txt --json

The default command makes no network calls. To check exact Python pins for fully yanked PyPI releases, opt in:

python3 agent_skills/dependency-doctor/scripts/dep_doctor.py requirements.txt --json --online

The doctor reports findings and suggested fixes but does not edit the manifest. Run the eval from a clone before installing:

python3 agent_skills/evals/dependency-doctor/test_dep_doctor.py

Scope

This focused check does not resolve a complete dependency graph and does not query a vulnerability database. Use the project's approved audit tool for CVE coverage. Ask before enabling the PyPI lookup or applying any suggested fix.

Apache-2.0. Last verified: July 2026.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning6d3 checks · Risk SAFE
  • Gen Agent Trust Hub6d

    This skill is a local development tool designed to audit dependency manifests (requirements.txt, pyproject.toml, package.json) for common configuration issues. It operates offline by default and only accesses pypi.org for package metadata if the user explicitly enables the 'online' mode.

  • Socket13d

    No alerts

  • Snyk6d

    Risk: MEDIUM · 2 issues

Signed by skilld at 14c5f8f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 4 months ago
Other metadata
compatibility
Python 3.11+. Offline by default. Network access to pypi.org occurs only when the user explicitly approves --online.
metadata
{
  "author": "Matt Van Horn",
  "version": "1.0.0",
  "source": "https://github.com/Shubhamsaboo/awesome-llm-apps"
}

README badge

README badge for shubhamsaboo/awesome-llm-apps/dependency-doctor