---
name: "depcheck-unused-npm-dependencies"
description: "Identify and purge unused dependencies, bloated devDependencies, and missing package references."
metadata:
  author: "depcheck"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "run depcheck"
  - "find unused npm packages"
  - "purge unused dependencies package.json"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# depcheck Unused & Missing npm Dependency Detection

Audits Node.js projects with depcheck: scanning imports and requires across all project files, detecting declared but unused packages in package.json, finding missing dependencies, and customizing ignore lists.

## When to Invoke
Invoke this skill whenever you need to:
- run depcheck
- find unused npm packages
- purge unused dependencies package.json

## Execution SOP & Rules
1. Run audit: npx depcheck . --ignores='@types/*,eslint-*,postcss,autoprefixer'.
2. Review reported 'Unused dependencies' and 'Unused devDependencies'.
3. Remove confirmed unused packages: pnpm remove <packages>.
4. Verify test and build pipelines succeed cleanly after package removal.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.