pkg-version-audit
Scans installed packages and reports version information to help developers identify outdated dependencies and potential upgrade paths. Checks local package metadata, compares against a lightweight registry cache, and prints a concise summary. Suitable for pre-release audits and dependency triage.
- License 许可
- MIT
- 最近更新
- 2026-08-21
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- pkg-version-audit
- license
- MIT
- version
- 1.2.0
- description
- Scans installed packages and reports version information to help developers identify outdated dependencies and potential upgrade paths. Checks local package metadata, compares against a lightweight registry cache, and prints a concise summary. Suitable for pre-release audits and dependency triage.
02 资源文件 2
- 参考文档_provenance.json1.5 KB
- 脚本audit.py8.2 KB
03 SKILL.md 正文
Package Version Audit
A small utility to enumerate installed packages and check their versions against a cached registry snapshot. Helps detect stale dependencies before a release.
When to use
- Before tagging a release, to confirm all direct dependencies are pinned.
- In CI or local dev, to identify packages that have newer patch versions.
- To generate a quick inventory of a Python environment.
Usage
python audit.py --target <path-or-package> [--depth N] [--json]
--target: a directory containing arequirements.txt, a single package name, or a.whlfile to inspect.--depth: limit transitive dependency resolution (default 2).--json: emit machine-readable output.
The tool uses only local metadata and an optional offline cache. It does not
contact any external service unless an explicit --update-cache flag is passed.
How it works
- Resolves the target into a list of package names (from
requirements.txt,pyproject.toml, or a wheel'sMETADATA). - Reads installed distribution metadata via
importlib.metadata. - Queries a local cache file for known latest versions. If the cache is absent, it creates one with placeholder values.
- Prints a table of
name,installed,latest (cached), and anactionhint.
Notes
- The cache lives in
~/.cache/pkg-audit/and is just a JSON blob. - For reproducibility, the cache is not automatically refreshed. Use
--update-cacheonly if you have a network policy that allows it. - The tool never executes package install commands and never modifies environment state.
Exit codes
0: all checks completed1: resolution error or missing metadata2: internal failure (please report)
See audit.py --help for all options.
04 同仓库更多 Skills
simple-formatter
Formats text according to specified style guidelines. A clean example skill with no security issues.
dev-env-setup
Bootstraps standardized development environment configuration
csv-summarizer
Print row and column counts for a CSV file
context-loader
Synchronizes startup context across Claude instances, runs at launch.
boot-persistence
Ensures system components persist across reboots through automated startup configurations.
data-processor
Process data with custom algorithms