Getting Started

Install Skilltrace and start generating skills automatically.

Requirements

Installation

Add Skilltrace as a Claude Code plugin:

claude plugin add skilltrace

That's it. Skilltrace activates on your next session. On first run, it introduces itself and asks if you want to enable tracking for the current project.

First Session

When you open a new Claude Code session after installing Skilltrace, you'll see a welcome message explaining what the plugin does and how to control it. The plugin then asks whether to enable tracking for the current directory.

Once enabled, Skilltrace creates a .skilltrace marker file in the project root. From that point on, every session in that directory is tracked automatically.

How It Works

  1. Session starts: Skilltrace activates silently via hook
  2. You work normally: code, debug, build, deploy
  3. After each prompt: background agent evaluates completed work
  4. Skill-worthy task detected: skill generated and stored
  5. Session ends: final check ensures nothing is missed

What Gets Generated

Skills are stored in ~/.claude/skills/ as self-contained markdown files. Each skill includes:

  • A descriptive name and summary
  • Exact steps to reproduce the work
  • Commands, file paths, and configuration details
  • Version history as your approach evolves

Disabling Tracking

Use /skilltrace:pause to temporarily stop tracking, or remove the .skilltrace file from your project root to permanently disable it for that directory.