auto-skill-ops-supercharge-maintenance-pass
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). Tr
SKILL.mdskills/auto-skill-ops-supercharge-maintenance-pass/SKILL.md
GitHubSupercharge Maintenance Pass
Generated by: Codex Supercharge maintenance automation.
Use this after adding/modifying skills, references, or scripts in
plugins/codex-supercharge/.
Workflow
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
Makefileshortcut:make validateIf you want installed copies updated under
~/.codex/skills, rerun with:SUPERCHARGE_PLUGIN="${SUPERCHARGE_PLUGIN:-plugins/codex-supercharge}" "$SUPERCHARGE_PLUGIN/scripts/maintenance_pass.sh" --installOr:
make installAfter meaningful Supercharge edits, refresh local feedback state:
make feedback
Notes
maintenance_pass.shruns:$SUPERCHARGE_PLUGIN/scripts/skill_audit.sh "$SUPERCHARGE_PLUGIN/skills"python3 "$SUPERCHARGE_PLUGIN/scripts/plugin_discovery_audit.py"$SUPERCHARGE_PLUGIN/scripts/validate_helpers.shquick_validate.pyfor each skill folder- (optional)
$SUPERCHARGE_PLUGIN/scripts/install_to_codex_skills.sh - (optional)
$SUPERCHARGE_PLUGIN/scripts/installed_drift.pyafter install
make feedbackappends a local.agent-runs/supercharge-feedback.jsonlbatch and refreshes.agent-runs/supercharge-status.mdfor future sessions.- If
quick_validate.pyis missing, install/restore the systemskill-creatorskill or setQUICK_VALIDATE_PYto 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"