| name | auto-skill-audit-codex-supercharge-installed-drift |
| description | Detect drift between the Codex Supercharge plugin pack and installed copies under `$HOME/.codex/skills`, including copied `SKILL.md`, `references/`, and `scripts/` payloads. Use when behavior differs across machines/sessions or after editing plugin skills, references, or helper scripts without reinstalling.
|
Codex Supercharge Installed Drift Audit
Generated by: Codex Supercharge maintenance automation.
Goal: quickly answer "are my installed Supercharge skills and copied helper
payloads the same as the plugin pack?"
Inputs
- Plugin pack root:
plugins/codex-supercharge
- Installed skills dir:
$HOME/.codex/skills (or CODEX_SKILLS_DIR)
Workflow
- List plugin-vs-installed drift across each Supercharge skill, copied
references, and copied helper scripts:
SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}"
python3 "$SUPERCHARGE_PLUGIN/scripts/installed_drift.py"
- If drift exists and you want installed copies to match the plugin pack:
SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}"
bash "$SUPERCHARGE_PLUGIN/scripts/install_to_codex_skills.sh"
- Re-run step 1 to confirm drift is gone.
Notes / Safety
- Resync overwrites and prunes installed copies for skills present in the plugin
pack so stale copied helper files and generated bytecode caches do not survive.
- Install sync excludes generated bytecode, local caches, source clones,
temporary files, logs, and common secret-bearing file extensions.
- Drift output intentionally ignores generated bytecode and local cache files.
- If you have local edits inside
$HOME/.codex/skills/<skill>/SKILL.md, copy them out before resyncing.
Skip when
- You intentionally maintain per-machine customizations in
$HOME/.codex/skills.
Validation
bash "$SUPERCHARGE_PLUGIN/scripts/skill_audit.sh" "$SUPERCHARGE_PLUGIN/skills"python3 "$SUPERCHARGE_PLUGIN/scripts/installed_drift.py"python3 "$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py" "$SUPERCHARGE_PLUGIN/skills/auto-skill-audit-codex-supercharge-installed-drift"
