One-click install
npx skills add https://github.com/carlos18bp/gym_project --skill vuln-audit-carlos18bp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vuln-audit
Source: https://github.com/carlos18bp/gym_project/tree/main/.agents/skills/vuln-audit
Command: npx skills add https://github.com/carlos18bp/gym_project --skill vuln-audit-carlos18bp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes the friction of manually auditing vulnerabilities and outdated dependencies by automating detection, safe patch+minor updates, and verification across the backend (Python) and frontend (npm) in the repo.

Core Features & Use Cases

  • Multi-surface auditing (backend + frontend): scans npm dependencies with npm audit/npm outdated and scans Python dependencies with pip-audit/pip list --outdated.
  • Safe update planning and application: applies only patch+minor updates within the current major, respecting existing version pins and avoiding forced major upgrades.
  • Operational guardrails: enforces a clean working tree, follows the repo git-branch-protocol, avoids full test runs (uses pytest --collect-only plus a minimal slice), and produces a structured audit-report.md.
  • Commit hygiene: creates up to three local commits in the correct order (frontend deps → backend deps → report) without pushing.

Quick Start

Run the skill to audit both surfaces and apply patch+minor updates: vuln-audit (no argument).

Frequently Asked Questions about vuln-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a vulnerability audit across both npm and Python dependencies safely?

A safe vulnerability audit scans both npm and Python dependencies, applies only patch and minor updates within the current major version, and verifies changes with a minimal build and test slice without forcing major upgrades.

What is the best way to apply patch and minor dependency updates without breaking version pins?

Enforcing pin-respecting upgrades avoids forced major version bumps, ensuring existing constraints remain intact while applying patch and minor dependency updates to reduce security and build risk.

Can I automate npm audit and pip-audit scans for a full-stack repository?

Yes, you can automate npm audit and pip-audit scans together for a full-stack repository by executing both package managers sequentially, detecting outdated dependencies, and generating a structured audit report.

Does dependency auditing require a clean git working tree before applying updates?

Dependency auditing requires a clean git working tree before applying updates to enforce operational guardrails and branch protocol compliance, ensuring local commits are created safely without conflicting changes.

Why should I avoid full test runs when applying security patches to dependencies?

You should avoid full test runs when applying security patches to minimize execution time and risk, using instead a minimal verification approach like pytest collection and a small test slice to validate dependency updates.

What limitations exist when using patch and minor updates for security compliance?

Limitations of using patch and minor updates for security compliance include the inability to resolve vulnerabilities requiring major version upgrades, as the process strictly respects existing version pins and avoids forced major bumps.