claude-code - 💡(How to fix) Fix [FEATURE] Display usage counts in /skills command

Official PRs (…)
ON THIS PAGE

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Code Example

"yeet:issue": {
  "usageCount": 69,
  "lastUsedAt": 1776415180600
}

---

/skills

  yeet:issue            ~1.2k tokens   69 uses   2d ago
  commit                ~800 tokens    41 uses   5h ago
  find-skills           ~600 tokens     3 uses   30d ago
RAW_BUFFERClick to expand / collapse

Problem

The /skills command currently shows only token counts for each skill. With dozens (or in some orgs, hundreds) of skills installed, token count alone isn't enough signal to decide what's worth keeping, pinning, or removing. The more useful signal — "how often do I actually use this skill?" — is already being tracked locally, just not surfaced.

~/.claude.json already stores per-skill usage data:

"yeet:issue": {
  "usageCount": 69,
  "lastUsedAt": 1776415180600
}

So the data is right there — it just isn't shown anywhere in the UI.

Proposed solution

In the /skills picker, add a column (or inline suffix) next to each skill showing:

  • usageCount — total invocations
  • optionally lastUsedAt as a relative timestamp (e.g. 2d ago)

Sort order could optionally default to most-used first, or stay alphabetical with the count shown on the right.

Rough mock:

/skills

  yeet:issue            ~1.2k tokens   69 uses   2d ago
  commit                ~800 tokens    41 uses   5h ago
  find-skills           ~600 tokens     3 uses   30d ago

No new tracking needed — just read what's already in claude.json.

Alternatives considered

  • Writing a separate shell script that parses claude.json and prints usage stats. Works, but duplicates data the TUI already has access to, and doesn't help in the moment I'm picking a skill.
  • Waiting for full skill analytics (#35319). That issue proposes a much bigger system (local JSONL log, CLI stats command, OTEL/webhook export). This request is a tiny subset — just display the counter that's already being incremented.

Priority

Low

Category

Interactive mode (TUI)

extent analysis

TL;DR

Displaying the usageCount from ~/.claude.json in the /skills picker can provide a useful signal for deciding which skills to keep, pin, or remove.

Guidance

  • Read the usageCount and lastUsedAt values from ~/.claude.json for each skill and display them in the /skills picker.
  • Consider sorting the skills by usageCount in descending order to prioritize the most used skills.
  • Use a relative timestamp format (e.g., 2d ago) to display the lastUsedAt value.
  • Ensure the display of usageCount and lastUsedAt does not duplicate existing data or functionality.

Example

// Example data from ~/.claude.json
"yeet:issue": {
  "usageCount": 69,
  "lastUsedAt": 1776415180600
}

// Example display in /skills picker
/skills

  yeet:issue            ~1.2k tokens   69 uses   2d ago
  commit                ~800 tokens    41 uses   5h ago
  find-skills           ~600 tokens     3 uses   30d ago

Notes

This solution only addresses displaying existing usage data and does not require new tracking or analytics functionality.

Recommendation

Apply workaround: Display the usageCount from ~/.claude.json in the /skills picker to provide a useful signal for skill management, as it is a low-priority but useful enhancement to the Interactive mode (TUI).

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [FEATURE] Display usage counts in /skills command