Claude Code Plugin

Analytics & Health
Monitor for
Claude Code Skills

Measure, track, and protect the quality of your skills over time. Like Google Analytics for your prompts — but local, private, and zero config.

# Top skills by usage (last 30 days)
/review 47 runs 60% satisfied 3,200 avg tokens
/test-fix 31 runs 78% satisfied 1,800 avg tokens
/git-push 28 runs 92% satisfied 400 avg tokens
⚠ Alerts:
/review — satisfaction dropping (72% → 58%) in 2 weeks
/plan — high token usage (5,100 avg) consider optimizing

Skills are blind after you write them

Static markdown files with no feedback loop. You never know if they're working until something goes wrong.

Activation rate mystery

Skill activation rate can drop to ~20% if descriptions are poor — no data to know it's happening.

Untracked corrections

Users constantly add follow-ups and corrections, but patterns go unnoticed and skills never improve.

Model update drift

When Claude updates, skill outputs quietly degrade. You find out after receiving bad code for weeks.

Token bloat

Skills grow with new features, increasing token waste. No baseline to compare current vs original.

No version science

Comparing two skill versions is guesswork. No way to know which performs better with real data.

Skill Evolver solves all of this

Auto-tracking, reaction detection, health alerts, version history, and A/B testing — zero config.


8 Core Features

Everything you need to evolve your skills

From automatic usage tracking to A/B testing — all local, all private.

Skill Usage Tracking

/skill-stats

Auto-collect data every time a skill is invoked via Claude Code hooks — trigger type, tokens, tool calls, duration, files, model version, and skill hash.

47
runs / month
92%
satisfied
3.2k
avg tokens

Reaction Detection

regex-based

Analyzes the next user message to classify satisfaction. No LLM — no circular dependency.

Satisfied — moved to next topic
Correction — "no, change that..."
Follow-up — "you forgot..."
Neutral — no clear pattern

Health Monitor

/skill-health

Detects degradation signals before they become problems.

Satisfaction drop alert > 15%
Token creep alert > 30%
Cancel rate alert > 10%
Model change any change

Correction Log

/skill-corrections

TF-IDF keyword clustering on correction messages. See patterns humans left behind.

45% "security/secrets/injection"
27% "too long/verbose"
18% "skip [section]"

Version Tracking & Rollback

/skill-history · /skill-rollback

Every SKILL.md change is snapshotted with SHA-256 hash. Satisfaction rates linked to each version. Roll back to any previous version in one command.

v1 Jan 15 45 lines (baseline) 78% satisfied
v2 Feb 01 52 lines (+7) 72% satisfied
v3 Feb 14 64 lines (+12) ⚠ 58% satisfied

Skill Guards

ConfigChange hook

Constraints that run on every SKILL.md edit. Warn before drift becomes permanent.

Line count > 500 lines
Lines grew > 30% from baseline
Step count changed ±3
Description > 200 chars

A/B Testing

/skill-ab

Compare two skill versions with real usage data. 50/50 random assignment. Results after 20 runs.

Version A
72%
satisfied
Version B
89%
▲ winner

Privacy-First & Zero Config

local SQLite · no telemetry

All data stays in a local SQLite database. Install the plugin and tracking starts automatically — nothing to configure.

Storage
Local only
~/.claude/skills/
Config required
Zero
hooks auto-register
Network calls
None
fully offline
AI dependency
None
pure heuristics

Setup in 60 seconds

How It Works

Three steps. Zero friction. Automatic from day one.

1

Install the Plugin

Add the repo from marketplace, then install. Two commands — hooks register automatically.

2

Use Your Skills Normally

Every skill invocation is tracked. Reactions detected. Versions snapshotted. All automatic.

3

Run Analytics Commands

Check stats, health, corrections, and version history anytime with slash commands.


12 Commands

Slash Commands

Run any of these directly inside Claude Code.

/skill-stats

Overview of all skills — top usage, satisfaction rates, token costs, and trend alerts.

/skill-stats <name>

Detailed analytics for a single skill: invocations, reactions breakdown, cost, trends.

/skill-corrections <name>

Raw correction messages + TF-IDF keyword clusters. Spot patterns humans left behind.

/skill-health

Health check all skills. Satisfaction drops, token creep, high cancel rates, model changes.

/skill-health <name>

Detailed health check for one skill with possible causes and rule-based suggestions.

/skill-history <name>

Version timeline with metrics per version. See exactly which change caused satisfaction to drop.

/skill-rollback <name>

List versions with metrics, pick one, and restore SKILL.md content instantly.

/skill-compare <name>

Side-by-side diff of two versions with metrics comparison.

/skill-ab start <name>

Start an A/B test between current and a new version. 50/50 random assignment per run.

/skill-ab status

View all running A/B tests with progress toward minimum sample size.

/skill-ab result <name>

Compare A vs B: satisfaction, tokens, correction rate, follow-up rate, duration.

/skill-export <name>

Export full run data and reactions to CSV or JSON for external analysis.


Design Philosophy

Built on principles, not hype

01

Data-driven, not AI-driven

The tool only measures and displays. No LLM used to fix or analyze your skills — avoids circular dependency and AI bias.

02

Human-in-the-loop always

Data reveals patterns. Humans decide what to change. The tool informs, never auto-edits your skills.

03

Zero config from day one

Install the plugin. Tracking starts automatically via Claude Code hooks. No setup, no configuration files.

04

Privacy-first, always local

All data lives in a local SQLite database. Nothing is sent to external servers. Your skill data is yours.

05

Minimal overhead

Hooks target <100ms execution. SQLite reads stay fast. Your coding workflow is never interrupted.

06

Like Google Analytics, but for prompts

GA shows bounce rates, drop-off points. Skill Evolver shows satisfaction drops, correction patterns. You decide what to fix.


Built with

Node.js ES Modules
SQLite (better-sqlite3)
Claude Code Hooks
TF-IDF (no heavy deps)
SHA-256 Hashing

Ready to install

Start evolving your skills

Free, open source, private. Install in 60 seconds and get automatic analytics from the first skill run.

# Add from marketplace
$ claude plugin marketplace add https://github.com/haidang1810/skill-evolver
✓ Plugin added to marketplace.
# Install the plugin
$ claude plugin install skill-evolver
✓ Plugin installed. Tracking enabled automatically.