auto-skill-ops-supercharge-maintenance-pass

name	auto-skill-ops-supercharge-maintenance-pass
description	Run a deterministic Codex Supercharge maintenance pass (skill audit, plugin discovery audit, helper smoke checks, quick validation, optional install sync plus installed-payload drift verification). Triggers: maintenance pass, validate skills, run skill audit, validate helper scripts, resync installed skills. Skip when you are not changing Codex Supercharge skills/scripts.

Supercharge Maintenance Pass

Generated by: Codex Supercharge maintenance automation.

Use this after adding/modifying skills, references, or scripts in plugins/codex-supercharge/.

Workflow

1. Run the local maintenance pass script:

   SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}"
   "$SUPERCHARGE_PLUGIN/scripts/maintenance_pass.sh"
   

   Or, from repo root, use the Makefile shortcut:

   make validate
   

2. If you want installed copies updated under ~/.codex/skills, rerun with:

   SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}"
   "$SUPERCHARGE_PLUGIN/scripts/maintenance_pass.sh" --install
   

   Or:

   make install
   

3. After meaningful Supercharge edits, refresh local feedback state:

   make feedback
   

Notes

• maintenance_pass.sh runs:
  • $SUPERCHARGE_PLUGIN/scripts/skill_audit.sh "$SUPERCHARGE_PLUGIN/skills"
  • python3 "$SUPERCHARGE_PLUGIN/scripts/plugin_discovery_audit.py"
  • $SUPERCHARGE_PLUGIN/scripts/validate_helpers.sh
  • quick_validate.py for each skill folder
  • (optional) $SUPERCHARGE_PLUGIN/scripts/install_to_codex_skills.sh
  • (optional) $SUPERCHARGE_PLUGIN/scripts/installed_drift.py after install
• make feedback appends a local .agent-runs/supercharge-feedback.jsonl batch and refreshes .agent-runs/supercharge-status.md for future sessions.
• If quick_validate.py is missing, install/restore the system skill-creator skill or set QUICK_VALIDATE_PY to its path.

Skip When

• You are only doing one-off repo work unrelated to Codex Supercharge.

Validation

SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}"
"$SUPERCHARGE_PLUGIN/scripts/maintenance_pass.sh"
python3 "$SUPERCHARGE_PLUGIN/scripts/plugin_discovery_audit.py" --plugin-root "$SUPERCHARGE_PLUGIN"
"$SUPERCHARGE_PLUGIN/scripts/validate_helpers.sh"
python3 "$SUPERCHARGE_PLUGIN/scripts/installed_drift.py"
python3 "$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py" "$SUPERCHARGE_PLUGIN/skills/auto-skill-ops-supercharge-maintenance-pass"