This skill should be used when the user asks to enable tracking, disable tracking, toggle auto-tracking, turn on/off automatic tracking, pause tracking, resume tracking, or control hooks-based tracking state. Manages .claude/.ref-autotrack marker file to activate/deactivate PostToolUse and SessionEnd hooks for automatic source and prompt tracking.
View on GitHubplugins/track/skills/auto/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/cadrianmae/claude-marketplace/blob/main/plugins/track/skills/auto/SKILL.md -a claude-code --skill autoInstallation paths:
.claude/skills/auto/## Tracking Status (Auto-Captured)
**Auto-Track**: !`[ -f .claude/.ref-autotrack ] && echo "✓ Enabled" || echo "✗ Disabled"`
**Sources Tracked**: !`wc -l < claude_usage/sources.md 2>/dev/null || echo "0"`
**Prompts Tracked**: !`grep -c '^Prompt:' claude_usage/prompts.md 2>/dev/null || echo "0"`
**Git Status**: !`git rev-parse --is-inside-work-tree &>/dev/null && echo "✓ Git repo" || echo "✗ Not a git repo"`
## Quick Example
```bash
/track:auto on
# ✓ Hooks-based tracking enabled
# PostToolUse: WebSearch/WebFetch/Read/Grep → claude_usage/sources.md
# SessionEnd: Major prompts → claude_usage/prompts.md
```
# auto - Control Hooks-Based Auto-Tracking
Toggle or explicitly set automatic hooks-based tracking state.
## Usage
```bash
/track:auto # Toggle between enabled/disabled
/track:auto on # Explicitly enable
/track:auto off # Explicitly disable
```
## What it does
1. **Check current status:**
- Looks for `./.claude/.ref-autotrack` marker file
- If exists → hooks-based tracking is enabled
- If missing → hooks are inactive
2. **Update state:**
- **No argument** → toggle current state
- **Argument "on"** → enable (create marker if missing)
- **Argument "off"** → disable (delete marker if exists)
3. **When enabling:**
- Creates `./.claude/.ref-autotrack` with metadata:
```
# Track Plugin v2.0 - Automatic Tracking Enabled
#
# Hooks configured:
# - PostToolUse: Tracks WebSearch, WebFetch, Read, Grep
# - UserPromptSubmit: Captures user prompts
# - SessionEnd: Pairs prompts with outcomes
#
# Initialized: <timestamp>
```
- Hooks activate automatically
- No skill invocation needed
4. **When disabling:**
- Deletes `./.claude/.ref-autotrack` marker file
- Hooks stop running
- Temporary files cleaned up
5. **Show new status:**
- Reports whether hooks-based tracking is now enabled or disabled
- Shows what will be tracked based on current config
- Explains ho