auto-skill-build-sources-inventory
Generate and refresh a metadata-only inventory of local `sources/` shallow clones (size, git remote, HEAD, commit date, license filename) and write it into `plugins/codex-supercharge/references/source
SKILL.mdskills/auto-skill-build-sources-inventory/SKILL.md
GitHubSources Inventory (auto-generated section)
Generated by: Codex Supercharge maintenance automation.
Goal: keep a lightweight, up-to-date index of local source clones so future
automation runs don’t waste tokens re-scanning sources/ manually.
Refresh the inventory
From the workspace root:
python3 plugins/codex-supercharge/scripts/sources_inventory.py --write
To inventory a different folder:
python3 plugins/codex-supercharge/scripts/sources_inventory.py --sources-dir <path> --write
What this does (and does not) do
- Captures metadata only: disk size, git remote, head SHA, commit timestamp, license filename.
- Does not execute any code from the repos.
- Does not treat metadata as a trust signal.
Output location
plugins/codex-supercharge/references/source-repos.md(between inventory markers)
Skip when
sources/does not exist.- The user is working only with remote repos (no local clone).
- You need a deep repo summary: use
$repo-intelligence-briefinstead.
References
plugins/codex-supercharge/references/source-repos.md- Safety gate:
$sandbox-source-intake,$mcp-safety-review
Validation
python3 plugins/codex-supercharge/scripts/sources_inventory.py | head