skill-usage

What This Skill Does

The skill-usage skill is a powerful analytical utility for OpenClaw users designed to provide granular insights into how various installed skills are being utilized. By processing your interaction history, this tool generates a professional, text-based visual report (TUI) that breaks down usage frequency, ranking, and activity trends. Whether you are curious about which automated tools are providing the most value or you simply want to optimize your workflow by identifying underutilized assets, skill-usage delivers actionable data directly within your terminal environment.

Installation

To integrate this utility into your OpenClaw ecosystem, execute the following command in your terminal:

clawhub install openclaw/skills/skills/akira82-ai/skills-usage

Once installed, the skill resides in your local configuration directory, allowing it to scan your history.jsonl files and project-specific session data to build its statistical reports.

Use Cases

• Workflow Optimization: Identify which skills are frequently used to automate repetitive tasks, helping you focus on scaling those workflows.
• Performance Review: Regularly audit your AI agent's effectiveness by measuring how often specific plugins are triggered compared to your goals.
• Cleanup and Maintenance: Find installed skills that have not been used in 90 days or more, allowing you to uninstall unused packages and keep your environment clean.
• Reporting: Easily share your agent's activity reports during team syncs by copying the formatted TUI output.

Example Prompts

1. "I'm curious about my productivity this week, can you show me a usage report for the past 7 days?"
2. "Run the skill-usage stats for today to see how often I've triggered my writing tools."
3. "Show me the full history of all skill activations since I started using OpenClaw."

Tips & Limitations

• Data Accuracy: This tool relies on the display field in your history files. If you manually edit historical data or rename skill directories, statistics may appear inaccurate.
• Resource Usage: For extremely large history.jsonl files (multi-year usage), the initial scan may take a few seconds. We recommend running the report frequently to keep the cache and history logs manageable.
• Scope: Note that the tool scans both global history and project-specific folders. If you keep sensitive projects in separate directories not standard to the OpenClaw structure, they may not be included in the aggregation. Ensure your projects follow the ~/.claude/projects/*/ convention for full visibility.