CatalogueSecurity & Compliance
Dependency & Supply Chain Risk Audit
Reads the lockfile and the full dependency tree for known vulnerabilities, abandoned packages, and names that are not what they seem.
What it examines
- Known vulnerabilities against the versions you actually installed
- Vulnerabilities two or three levels down the tree
- Packages with no maintainer, no recent release, or an explicit deprecation
- Licenses that conflict with how you distribute the software
- Typosquats, packages you declare and never import, and duplicated versions of the same library
What you get back
A findings file. Each item has the evidence, how serious it is, and a fix.
Dependencies
- An AI coding agent that reads SKILL.md files, such as Claude Code, Codex or Gemini CLI
- Read access to the repository
- The lockfile, such as package-lock.json, yarn.lock, poetry.lock, Gemfile.lock or go.sum. The audit needs it to know the exact versions in use.
- Python 3 with the jsonschema package, to check findings.json before fixing anything
How it works
The audit is read-only. It checks the versions in your lockfile against known advisories and uses real advisory ids, never invented ones.
It walks the full dependency tree, because a flaw two or three levels down is still exposure. It also flags unmaintained packages, licence conflicts with how you distribute the code, and look-alike or never-imported packages.
You get findings.json and findings.md. The remediate skill reads findings.json. It applies simple upgrades with tests, asks you to approve riskier ones and plans the rest.
Setup
- Unzip the download. Copy the audit and remediate folders into your agent's skills folder (for Claude Code, .claude/skills/) in the repository you want to check.
- Check that the lockfile is committed. Without it the results are estimates.
- Open the repository in your agent and ask it to run the a3-dependency-supply-chain-audit skill.
- Check the result with the validator: pip install jsonschema, then python3 schema/validate.py findings.json.
- Ask your agent to run the a3-dependency-supply-chain-remediate skill using findings.json. Fix some findings and leave the rest open if you like.
Run it with your agent
Copy the prompt, fill in the parts in square brackets, and paste it into your agent.
Run the a3-dependency-supply-chain-audit skill on this repository. The lockfile is at [path to lockfile]. Mode: audit only. Do not change any code. Write findings.json and findings.md in the repository root.
Run the a3-dependency-supply-chain-remediate skill using findings.json. Work through the findings I choose, and leave the rest open.