| name | cc-skills-usage |
| description | Analyze Claude Code skill usage and display results in the terminal. View usage frequency, per-project statistics, token consumption, and more. |
| argument-hint | [options] |
cc-skills-usage
Run the CLI analyzer for Claude Code skill usage and display the results.
How to Run
Execute the following command using the Bash tool:
bunx cc-skills-usage@0.1.1 [user-specified options]
If the user provides arguments, pass them directly to the command. If no arguments are given, run without options.
Available Options
| Option | Short | Description |
|---|
--from <date> | | Start date filter (YYYY-MM-DD) |
--to <date> | | End date filter (YYYY-MM-DD) |
--project <name> | -p | Partial match filter on project path |
--skill <name> | -s | Skill name filter |
--output <mode> | -o | terminal (default) or web |
--limit <number> | -n | Number of recent calls to display (default: 50) |
--port <number> | | Web server port (default: 3939) |
--conversations | | Include all session data |
--claude-dir <path> | | Override ~/.claude location |
Usage Examples
/cc-skills-usage — Show usage stats for all skills
/cc-skills-usage --from 2025-06-01 — Usage since June 1st
/cc-skills-usage --skill example-skill — Usage for the example-skill skill only
/cc-skills-usage --project myapp --from 2025-06-01 — Filter by project and date range
/cc-skills-usage --output web — Open dashboard in browser
/cc-skills-usage --conversations — Detailed analysis including all conversation data
Notes
- Display the command output as-is to the user. Do not modify or summarize the output.
- When using
--output web, the browser opens automatically.