linux-game-manager/.codex/skills/linux-game-manager-dev/references/skill-maintenance.md

Skill Maintenance (Critical)

This skill is only trustworthy if it is refreshed immediately after behavior changes.

Mandatory Refresh Triggers

Run this maintenance workflow whenever any of these change:

• linux-game-manager.sh
• Anything in .install/
• Anything in .launch/
• Anything in .update/
• Anything in speech/
• README.md
• Any game lifecycle contract (install path usage, symlink behavior, update function contracts, CLI flags)

Refresh Workflow

1. Run catalog audit and capture output:

python3 .codex/skills/linux-game-manager-dev/scripts/audit_game_catalog.py

2. Re-check core flow definitions in linux-game-manager.sh:

rg -n "game_installer|game_launcher|game_removal|game_update|getopts|help\\(" linux-game-manager.sh

3. Update skill references:

• Update references/core-map.md catalog snapshot if counts changed.
• Update references/core-map.md flow descriptions if behavior changed.
• Update references/game-extension.md if onboarding or naming rules changed.
• Update this file if refresh triggers or process changed.

4. Validate the skill structure:

python3 /home/storm/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/linux-game-manager-dev

5. If any bash scripts changed, run shellcheck on edited files and fix all errors.
   • If shellcheck is missing, pause and prompt the user to install it using references/tooling-prereqs.md.

Completion Criteria

Do not consider maintenance complete until all are true:

1. Catalog audit shows no critical mismatches, and any warnings are reviewed.
2. All changed behavior is reflected in skill reference files.
3. Skill passes quick_validate.py.
4. Any edited bash scripts are shellcheck-clean.