Skill Tail

Track and report Claude Code skill usage statistics.

English | 中文

English

Features

• 📊 Automatically track which skills are used in Claude Code
• 📈 View daily and weekly statistics
• 🔧 One-command setup with npx skill-tail init

Installation

No installation needed! Use directly with npx:

npx skill-tail init

Quick Start

1. Initialize skill-tail:

npx skill-tail init

This will:

• Create statistics directory at ~/.claude/skills/skill-tail/
• Initialize empty stats.json
• Add tracking rules to ~/.claude/CLAUDE.md

2. Use Claude Code normally

When you use skills in your conversation, you'll see a footer like:

---
📊 Skills Used: `vue`, `vite`

The statistics will be recorded automatically.

3. View statistics:

# Show all statistics
npx skill-tail report

# Show today only
npx skill-tail report --today

# Show this week only
npx skill-tail report --week

# Output as JSON
npx skill-tail report --json

Commands

| Command | Description | |---------|-------------| | npx skill-tail init | Initialize and setup tracking | | npx skill-tail report | Show usage statistics | | npx skill-tail report --today | Show today's usage | | npx skill-tail report --week | Show this week's usage | | npx skill-tail record <skills> | Manually record skill usage | | npx skill-tail reset -y | Reset all statistics |

How It Works

1. init command adds tracking instructions to your ~/.claude/CLAUDE.md
2. Claude Code reads these instructions and follows them
3. After each response that uses skills, Claude runs npx skill-tail record
4. Statistics are stored in ~/.claude/skills/skill-tail/stats.json

中文

功能

• 📊 自动追踪 Claude Code 中使用的 skill
• 📈 查看每日和每周统计
• 🔧 一条命令完成设置：npx skill-tail init

安装

无需安装！直接使用 npx：

npx skill-tail init

快速开始

1. 初始化 skill-tail：

npx skill-tail init

这会：

• 在 ~/.claude/skills/skill-tail/ 创建统计目录
• 初始化空的 stats.json
• 在 ~/.claude/CLAUDE.md 添加追踪规则

2. 正常使用 Claude Code

当你在对话中使用 skill 时，会在响应末尾看到：

---
📊 Skills Used: `vue`, `vite`

统计数据会自动记录。

3. 查看统计：

# 显示所有统计
npx skill-tail report

# 只看今天
npx skill-tail report --today

# 只看本周
npx skill-tail report --week

# JSON 格式输出
npx skill-tail report --json

命令

| 命令 | 说明 | |------|------| | npx skill-tail init | 初始化并设置追踪 | | npx skill-tail report | 显示使用统计 | | npx skill-tail report --today | 显示今天的使用情况 | | npx skill-tail report --week | 显示本周的使用情况 | | npx skill-tail record <skills> | 手动记录 skill 使用 | | npx skill-tail reset -y | 重置所有统计 |

工作原理

1. init 命令将追踪指令添加到 ~/.claude/CLAUDE.md
2. Claude Code 读取这些指令并遵循执行
3. 每次响应使用了 skill 后，Claude 运行 npx skill-tail record
4. 统计数据存储在 ~/.claude/skills/skill-tail/stats.json

License

MIT