dependency-audit
Analyzes project dependencies for known security vulnerabilities using npm audit, pip-audit, or similar tools. Use when auditing packages, checking for CVEs, or updating vulnerable dependencies.
When & Why to Use This Skill
The Dependency Audit skill automates the detection and remediation of security vulnerabilities within software project dependencies. It supports multiple ecosystems including Node.js, Python, Go, Ruby, and Rust, providing developers with actionable insights into CVEs, severity assessments, and precise fix commands to maintain a secure and compliant codebase.
Use Cases
- Routine Security Auditing: Periodically scanning project manifests (package.json, requirements.txt, etc.) to identify newly discovered vulnerabilities in existing dependencies.
- Vulnerability Remediation: Generating specific update commands or manual fix instructions for critical and high-severity CVEs, including handling complex transitive dependency overrides.
- Pre-deployment Compliance: Running automated security checks before merging code or deploying to production to ensure no known security risks are introduced into the environment.
- CI/CD Pipeline Integration: Configuring automated security gates in GitHub Actions or pre-commit hooks to block builds that contain vulnerabilities exceeding a specific severity threshold.
| name | dependency-audit |
|---|---|
| description | Analyzes project dependencies for known security vulnerabilities using npm audit, pip-audit, or similar tools. Use when auditing packages, checking for CVEs, or updating vulnerable dependencies. |
Dependency Audit
Quick Start
Audit dependencies based on project type:
# Node.js
npm audit
# Python
pip-audit
# Go
govulncheck ./...
Instructions
Step 1: Identify Package Manager
Check for manifest files:
package.json/package-lock.json→ npm/yarnrequirements.txt/pyproject.toml→ pipgo.mod→ Go modulesCargo.toml→ Cargo (Rust)Gemfile→ Bundler (Ruby)
Step 2: Run Audit
Node.js (npm):
npm audit
npm audit --json # Machine-readable output
Node.js (yarn):
yarn audit
yarn audit --json
Python:
pip install pip-audit
pip-audit
pip-audit -r requirements.txt
Go:
govulncheck ./...
Ruby:
bundle audit check --update
Step 3: Analyze Results
Categorize by severity:
| Severity | CVSS | Action |
|---|---|---|
| Critical | 9.0+ | Update immediately |
| High | 7.0-8.9 | Update within 24h |
| Moderate | 4.0-6.9 | Update this sprint |
| Low | < 4.0 | Update when convenient |
Step 4: Fix Vulnerabilities
npm - Auto-fix:
npm audit fix
npm audit fix --force # Breaking changes allowed
npm - Manual update:
npm update vulnerable-package
# or specific version
npm install vulnerable-package@2.0.0
Python - Update package:
pip install --upgrade vulnerable-package
# or pin safe version in requirements.txt
vulnerable-package>=2.0.0
Step 5: Verify Fixes
Re-run audit to confirm:
npm audit # Should show 0 vulnerabilities
pip-audit # Should show no issues
Common Scenarios
Transitive Dependencies
When vulnerability is in a sub-dependency:
# Check dependency tree
npm ls vulnerable-package
# Force resolution (npm)
# Add to package.json:
{
"overrides": {
"vulnerable-package": "2.0.0"
}
}
No Fix Available
When no patched version exists:
- Check if vulnerability affects your usage
- Consider alternative packages
- Implement workarounds if possible
- Monitor for updates
Breaking Changes
When fix requires major version bump:
- Review changelog for breaking changes
- Update code to accommodate changes
- Run tests thoroughly
- Consider gradual rollout
Report Format
## Dependency Audit Report
**Project:** my-app
**Date:** 2024-01-15
**Total Dependencies:** 245
**Vulnerabilities Found:** 3
### Critical (1)
**lodash** - Prototype Pollution
- Installed: 4.17.15
- Fixed in: 4.17.21
- CVE: CVE-2021-23337
- Fix: `npm install lodash@4.17.21`
### High (1)
**axios** - SSRF Vulnerability
- Installed: 0.21.0
- Fixed in: 0.21.2
- CVE: CVE-2021-3749
- Fix: `npm install axios@0.21.2`
### Moderate (1)
**minimist** - Prototype Pollution
- Installed: 1.2.5
- Fixed in: 1.2.6
- CVE: CVE-2021-44906
- Fix: `npm audit fix`
CI/CD Integration
GitHub Actions
- name: Audit dependencies
run: |
npm audit --audit-level=high
# Fails if high or critical vulnerabilities found
Pre-commit
# package.json scripts
{
"scripts": {
"precommit": "npm audit --audit-level=moderate"
}
}