---
name: stats
description: Report usage counts of every jsc skill and every skill call chain, aggregated by tools/usage-stats.sh from $JSC_HOME/usage/*.jsonl recorded by jsc-hooks. Supports --cli filtering. Use when the user asks how often skills or chains are used; not for token or time stats (see worklog).
---

# stats — skill and call-chain usage counts

Data is recorded continuously by `jsc-hooks/hooks/skill-usage.sh` under `$JSC_HOME/usage/` (default `~/.jsc/usage/`).

## Operations

| Count | Command | Output |
| --- | --- | --- |
| Uses per skill | `tools/usage-stats.sh skills` | `count<TAB>skill`, descending |
| Uses per call chain | `tools/usage-stats.sh chains` | `count<TAB>from -> to`, descending |
| Filter by CLI | Append `--cli claude` (or codex / copilot / antigravity / kiro) | Same as above |

## Reporting

1. Run the tool directly and present the output as a table. Done when every line the tool printed appears as one table row.
2. When the tool prints no rows, explain that `jsc-hooks` must be installed and wired first via `jsc-hooks:hooks-install`. Done when that instruction is reported and no table is shown.