This skill should be used when the user asks to initialize tracking, set up reference tracking, enable automatic source tracking, create tracking files, or start using the track plugin for the current project. Creates claude_usage/ directory with sources.md and prompts.md files, configures hooks-based automatic tracking with verbosity settings, and enables PostToolUse and SessionEnd hooks.
View on GitHubplugins/track/skills/init/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/cadrianmae/claude-marketplace/blob/main/plugins/track/skills/init/SKILL.md -a claude-code --skill initInstallation paths:
.claude/skills/init/## Tracking Status (Auto-Captured)
**Tracking Enabled**: !`[ -f .claude/.ref-autotrack ] && echo "✓ Active" || echo "✗ Inactive"`
**Sources File**: !`[ -f claude_usage/sources.md ] && echo "✓ Exists ($(wc -l < claude_usage/sources.md) entries)" || echo "✗ Not created"`
**Prompts File**: !`[ -f claude_usage/prompts.md ] && echo "✓ Exists ($(grep -c '^Prompt:' claude_usage/prompts.md 2>/dev/null || echo 0) entries)" || echo "✗ Not created"`
**Git Status**: !`git rev-parse --is-inside-work-tree &>/dev/null && echo "✓ Git repo" || echo "✗ Not a git repo"`
## Quick Example
```bash
/track:init
# Creates: claude_usage/sources.md (with preamble)
# claude_usage/prompts.md (with preamble)
# .claude/.ref-config (with default settings)
# .claude/.ref-autotrack (enables hooks-based tracking)
```
# init - Initialize Hooks-Based Tracking
Initialize automatic reference and prompt tracking for the current project.
## What it does
1. **Create claude_usage/ directory:**
- Creates `./claude_usage/` directory for tracked files
- Visible (not hidden) for easy access and review
2. **Create tracking files with preambles:**
- Creates `./claude_usage/sources.md` with explanatory preamble
- Creates `./claude_usage/prompts.md` with explanatory preamble
- If files exist, leaves them unchanged
- Preambles explain format, usage, and configuration
3. **Create `.claude/` directory structure:**
- Creates `./.claude/` directory if missing
- Creates `./.claude/.ref-config` with default settings:
```
PROMPTS_VERBOSITY=major
SOURCES_VERBOSITY=all
EXPORT_PATH=exports/
```
- Creates `./.claude/.ref-autotrack` marker file with metadata
4. **Enable hooks-based tracking:**
- Hooks activate automatically when `.ref-autotrack` exists
- PostToolUse hook → tracks WebSearch/WebFetch/Read/Grep
- UserPromptSubmit hook → captures user prompts
- SessionEnd hook → pairs prompts with outcomes
- **No skill activation