skill-usage_skill

Overview

This skill counts how often installed skills were used during a chosen time range and displays the results in a clean TUI-style report. It produces per-skill call counts, ranked frequency, totals, and simple trend visuals so you can quickly see which skills you rely on most. The output is formatted as a readable table with inline bar charts for immediate insight.

How this skill works

The skill scans installed skill definitions and parses available conversation history to find records that indicate skill invocations. It filters events by timestamp to the requested time window, aggregates calls per skill, computes totals and relative frequencies, and sorts results by usage. The final report is rendered as a tidy table with ASCII/Unicode bar visuals and a summary line.

When to use it

• After a period of active use to discover which skills you use most
• Before cleaning up or reorganizing installed skills to identify candidates for removal
• When auditing activity across projects to compare per-project versus global usage
• To generate periodic usage snapshots (daily, weekly, monthly, quarterly, or all-time)

Best practices

• Choose a time window that matches the cadence you want to analyze (week, month, quarter)
• Include both global and project conversation history so usage counts are comprehensive
• Run the report regularly to track trends and detect shifts in which skills are favored
• Treat zero-use entries as candidates for pruning, but validate before removing
• Keep history data intact long enough to analyze multi-month trends if needed

Example use cases

• Run a 30-day report to see which skill handled the most tasks this month
• Compare past-7-days vs past-30-days to detect rising or falling usage patterns
• Produce an all-time leaderboard before deciding which community skills to keep
• Audit usage across project sessions to allocate maintenance effort where it matters