auto-skill-audit-codex-supercharge-installed-drift

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

SKILL.md

GitHub

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

  1. 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"
  1. 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"
  1. 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"