# 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:

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

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

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

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