Skip to content

Lover0ne/skilltrace

Repository files navigation

Skilltrace

Skilltrace

Designed for Claude Code

Your work becomes reusable. Automatically.

Visit the official website

Skilltrace is a Claude Code plugin that silently watches your coding sessions and converts completed tasks into replayable, self-contained skills — without you lifting a finger.


The Problem

Skills are the most powerful invention in agentic AI. They turn one-time work into reusable knowledge. So I asked myself: why not leverage them at every possible opportunity?

But here's the catch — every time I set up auth, configured a CI pipeline, or wired up an MCP server, I knew that knowledge would evaporate at the end of the session. Next time, I'd start from scratch. Same research, same trial and error, same cost. I wanted to capture everything, but I also just wanted to work on my projects. Writing skills means stopping, reflecting, documenting steps, structuring files — it's a second job on top of the actual job. I was spending more time writing skills than building things.

So I thought: why am I doing this when AI can do it for me?

That's how Skilltrace was born.

The Idea

Skilltrace is a silent assistant that works alongside you. It doesn't interrupt. It doesn't pollute your context. It doesn't ask questions.

While you focus on your project, Skilltrace runs in the background:

  • Observes your conversations and tool usage across sessions
  • Detects when meaningful, reproducible work is completed
  • Generates specific, self-contained skills with exact steps, commands, and file paths
  • Versions skills automatically when your approach evolves
  • Organizes everything by project, searchable and ready to replay

You work. It learns. Your effort compounds.

Why It Matters

  • Stop reinventing the wheel — what you build once becomes a reusable recipe forever
  • Cut costs — skills let Claude replay proven approaches in seconds instead of reasoning from scratch every session
  • Share knowledge — skills are portable files; drop them in a shared folder and your entire team benefits
  • Never start from zero — every project feeds your skill library; the more you use Claude, the faster it gets

Install

claude plugin add /path/to/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.

How It Works

When What happens
Session starts Skilltrace activates silently via hook
You work normally Code, debug, build, deploy — no interruptions
After each prompt Background agent evaluates if meaningful work was completed
Skill-worthy task detected Skill generated automatically, stored in ~/.claude/skills/
Session ends Final check — nothing missed

No configuration. No context pollution. No extra prompts. Just work.

Features

  • Zero overhead — runs via hooks, never touches your main conversation
  • Per-project tracking — opt-in per directory, each project gets its own skill library
  • Smart versioning — skills evolve with your approach; old versions archived, not lost
  • Specific skills — not "how to set up auth" but "setting up NextJS auth with Clerk and Drizzle ORM"
  • Self-contained — every skill is a complete recipe, replayable with zero prior context
  • Skill inventory — browse, search, and inspect all skills across projects
  • Pause/resume — disable tracking anytime with /skilltrace:pause
  • Cross-platform — works on macOS, Linux, and Windows

Commands

Command What it does
/skilltrace:skills List all skills with descriptions, versions, and project info
/skilltrace:status Show tracking status and skill counts
/skilltrace:pause Pause activity tracking
/skilltrace:resume Resume activity tracking
/skilltrace:reindex Rebuild skill registry from files on disk

Project Structure

skilltrace/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── hooks/
│   ├── hooks.json           # Hook definitions (SessionStart, UserPromptSubmit, SessionEnd)
│   └── wrapper.sh           # Cross-platform dispatcher
├── src/
│   ├── cli.py               # CLI entry point (13 commands)
│   ├── config.py            # Enable/disable, configuration
│   ├── registry.py          # Skill registry CRUD
│   ├── shared.py            # Atomic file ops, project ID management
│   ├── skill_ops.py         # Skill creation, versioning, archiving
│   └── transcript.py        # Session transcript scraper
├── agents/
│   └── skill-checker.md     # Background agent that evaluates and generates skills
├── commands/                 # Slash commands (pause, resume, status, skills, reindex)
└── skills/
    └── skilltrace-manage/    # Built-in skill for managing generated skills

Requirements

Support

If you'd like to go the extra mile — buy my dogs some treats 🐶

License

MIT


Stop writing skills. Start working. Let Skilltrace handle the rest.

Releases

No releases published

Packages

 
 
 

Contributors