footgun-scan
Installation
SKILL.md
Footgun scan
scripts/scan.py matches 32 patterns against the lines a change adds. Each pattern is tied to one
trap file in the kotlin-footguns area skills. It finds shapes, not bugs: every hit needs the trap's
judgment before it becomes a finding.
Run it
From inside the user's git repository, with this skill's base directory as <skill>:
python3 <skill>/scripts/scan.py # lines added in the working tree and index since HEAD
python3 <skill>/scripts/scan.py --base origin/main # lines added on this branch since it left main
python3 <skill>/scripts/scan.py --all src/ # every line under a path: an audit, and noisier
Pick the scope from the request. Uncommitted work takes the default. A branch or pull request takes
--base with its target branch. "Audit the codebase" takes --all, narrowed to the paths that matter.
For a pre-commit hook or CI step, add --fail to exit 1 on any likely hit.