| name | gamify |
| description | Install usage tracking hooks and build a levelup skill to advise the user. |
| type | lesson |
Lesson — set up gamification for {{ backend }}
Two parts:
Part 1 — install the tracking hooks
Run in your shell tool:
agex gamify --agent {{ backend }}
This writes backend-native hook fragments that call agex hook write <event> whenever you use a tool, submit a prompt, or stop. The events land in .agex/data/.
To uninstall: agex gamify --uninstall --agent {{ backend }}.
Part 2 — build the levelup skill
The hook data is inert without something to surface it. Build the levelup skill described in agex learn levelup --agent {{ backend }}, or copy its skill template directly:
.claude/skills/levelup/SKILL.md
{{ skill_template_body }}
After both parts
Use your runtime normally for a few sessions. Then invoke /levelup — it will read the tracking data via agex hook read and advise the user.