Agent Skills › Security & Maintenance › dependency-doctor

Security & Maintenance

🩺 dependency-doctor

Audit vulnerable, outdated and unused packages with a safe upgrade plan. A free, open-source Agent Skill for Claude Code, Cline, Cursor, Codex and 75+ AI agents.

Install dependency-doctor

# Claude Code (all 51 skills)
/plugin install all-skills --marketplace milad-ahmd/agent-skills

# Cursor, Codex, Cline, Windsurf, Copilot + 75 more agents
npx skills add milad-ahmd/agent-skills --skill dependency-doctor

# Shell installer
curl -fsSL https://raw.githubusercontent.com/milad-ahmd/agent-skills/main/install.sh | bash -s -- dependency-doctor

Included in packs: startup-cto-pack, developer-pack

What to say to your agent

When it triggers

Audits project dependencies for vulnerabilities, outdated and unused packages, and produces a safe, ordered upgrade plan with breaking-change notes. Use when the user asks to update dependencies, fix npm/pip audit warnings, check for vulnerable packages, or plan a major-version upgrade.

Full skill instructions (SKILL.md)

Dependency Doctor

Diagnose first, then treat. Never upgrade everything blindly.

1. Diagnose (read-only)

Detect the ecosystem from its lockfile and run the matching tools:

EcosystemOutdatedVulnerabilities
npm / pnpm / yarnnpm outdated / pnpm outdated / yarn outdatednpm audit --json / pnpm audit
Pythonpip list --outdated / uv pip list --outdated / poetry show --outdatedpip-audit
Gogo list -u -m allgovulncheck ./...
Rustcargo outdatedcargo audit
Rubybundle outdatedbundle audit
PHPcomposer outdatedcomposer audit
Flutter/Dartflutter pub outdated—

If a tool isn't installed, say so and fall back to reading the manifest. Find unused dependencies by searching for each package's import across the source.

2. Report

## 🩺 Dependency Health: <project>
| Package | Current | Latest | Type | Risk | Action |
|---|---|---|---|---|---|
| lodash | 4.17.15 | 4.17.21 | patch | 🔴 CVE-2021-23337 (high) | upgrade now |
| react | 17.0.2 | 18.3.1 | major | 🟠 breaking | planned migration |
| moment | 2.29.4 | — | — | 🟡 unused | remove |

3. Treatment plan (ordered from safest to riskiest)

  1. Security fixes (patch/minor) → 2. Remove unused packages → 3. Patch and minor bumps in small batches → 4. One major upgrade at a time.

For every major upgrade, check the package's CHANGELOG or release notes, list the breaking changes that affect this codebase (search for the APIs that changed) and estimate the effort.

4. Execute (only after the user confirms)

  • Upgrade one batch, reinstall, then run the build, type-check and tests. Stop and report at the first failure.
  • Always update the lockfile through the package manager. Never hand-edit lockfiles.
  • Never use --force or --legacy-peer-deps, and never ignore audit findings, without explaining the trade-off.

View source on GitHub ⭐ Star the collection

Related skills