Hooks System
How Skilltrace integrates with Claude Code without touching your conversation.
Overview
Skilltrace uses Claude Code's hook system to run at key moments during your session. Hooks are defined in hooks/hooks.json and dispatched via a cross-platform wrapper script.
Hook Events
| Event | When | What Skilltrace Does |
|---|---|---|
SessionStart | Session opens | Prints welcome message, checks if tracking is enabled |
UserPromptSubmit | After each user prompt | Spawns background agent to evaluate completed work |
SessionEnd | Session closes | Final evaluation pass to catch anything missed |
Zero Context Pollution
Hooks run outside your main conversation. Skilltrace never injects text into your chat, never adds system prompts, and never consumes your context window.
Cross-Platform Dispatch
The hooks/wrapper.sh script handles platform detection and routes hook events to the appropriate Python handlers. Works on macOS, Linux, and Windows.