cc-skills-usage

cc-skills-usage

A CLI tool for analyzing and visualizing Claude Code skill usage.

Scans JSONL conversation history stored in ~/.claude/projects/, and aggregates skill invocation counts, per-project usage, token consumption, daily trends, and more.

Requirements

• Bun

Usage

bunx cc-skills-usage@latest

Options

Flag	Short	Description
--output <mode>	-o	Output mode: terminal (default) or web
--from <date>		Start date filter (YYYY-MM-DD)
--to <date>		End date filter (YYYY-MM-DD)
--project <name>	-p	Filter by project name (partial match)
--skill <name>	-s	Filter by skill name
--port <number>		Web server port (default: 3939)
--claude-dir <path>		Override ~/.claude path
--limit <number>	-n	Number of recent invocations to display (default: 50)
--help	-h	Show help

Examples

# Display in terminal
bunx cc-skills-usage@latest

# Display as web dashboard (automatically opens browser)
bunx cc-skills-usage@latest --output web

# Filter by date range and skill name
bunx cc-skills-usage@latest --from 2025-06-01 --to 2025-06-30 --skill review-pr

# Check usage for a specific project
bunx cc-skills-usage@latest --project my-app

Claude Code Skills

This package ships two Claude Code skills that can be invoked as slash commands.

Skill	Command	Description
cc-skills-usage	/cc-skills-usage	Run the analyzer and display skill usage stats directly in your Claude Code session
analyze-skill	/analyze-skill <name>	Analyze a specific skill's usage data, identify missed triggers, and suggest improvements to its SKILL.md

Install

bunx skills add shinyaigeek/cc-skills-usage/skills/cc-skills-usage
bunx skills add shinyaigeek/cc-skills-usage/skills/analyze-skill

Skill Detection

Skill invocations are detected through two mechanisms:

• Skill tool_use — tool_use blocks (name: "Skill") in assistant messages
• Slash commands — <command-name> tags in user messages (e.g., /example-skill, /review-pr)

Built-in CLI commands (/help, /clear, etc.) are excluded. When the same skill is detected by both mechanisms, duplicates are removed.