Skip to content

Arnie016/codex-prompt-templates / skills/auto-skill-build-sources-inventory

auto-skill-build-sources-inventory

Verified

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-repos.md`. Use when you want a fast “what sources do we have?” view, to control disk growth, or before doing a source-pattern synthesis pass. Skip when there is no `sources/` directory or you are not working with local clones.

FileKindSize
SKILL.mdskill md1.7 KB
---
name: auto-skill-build-sources-inventory
description: >
  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-repos.md`. Use when you
  want a fast “what sources do we have?” view, to control disk growth, or
  before doing a source-pattern synthesis pass. Skip when there is no `sources/`
  directory or you are not working with local clones.
---

# 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:

```bash
python3 plugins/codex-supercharge/scripts/sources_inventory.py --write
```

To inventory a different folder:

```bash
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

```bash
python3 plugins/codex-supercharge/scripts/sources_inventory.py | head
```
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall