Skip to content

Arnie016/codex-prompt-templates / skills/auto-skill-ops-supercharge-maintenance-pass

auto-skill-ops-supercharge-maintenance-pass

Verified

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.

FileKindSize
SKILL.mdskill md2.6 KB
---
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:

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

   Or, from repo root, use the `Makefile` shortcut:

   ```bash
   make validate
   ```

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

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

   Or:

   ```bash
   make install
   ```

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

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

```bash
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"
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall