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.md

GitHub

Sources 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-brief instead.

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