← Back to Skills Marketplace
Skill Usage
by
akira82-ai
· GitHub ↗
· v0.1.0
· MIT-0
153
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skills-usage
Description
统计已安装技能在指定时间段内的使用次数，以美观的 TUI 格式展示结果
Usage Guidance
This skill reads your Claude conversation history files (~/.claude/history.jsonl and files under ~/.claude/projects/) and the ~/.claude/skills/ directory to compute usage counts — that is necessary for its purpose but exposes sensitive local data. Before installing or running: review stats.py (already included) to confirm it only aggregates counts (it does), ensure you trust the skill source, and verify file permissions. If you want tighter safety, run the script manually in a shell (python3 ~/.claude/skills/skill-usage/stats.py past_30_days) rather than allowing autonomous invocation, or make a copy of your history files for testing. Note the SKILL.md and README contain slightly different path descriptions (session.jsonl vs any *.jsonl), but the script's behavior is consistent and broader (it scans all *.jsonl under projects).
Capability Analysis
Type: OpenClaw Skill
Name: skills-usage
Version: 0.1.0
The skill-usage bundle is a legitimate utility designed to track and display usage statistics for Claude Code skills. It operates by parsing local history files (~/.claude/history.jsonl and project session files) using a Python script (stats.py) to count occurrences of skill-invocation patterns. The code lacks any network activity, data exfiltration, or unauthorized execution patterns, and its behavior aligns perfectly with its stated purpose.
Capability Assessment
Purpose & Capability
Name/description match what the files implement: stats.py and SKILL.md both enumerate installed skills and parse local Claude history files to produce usage counts and a TUI-like report. Required resources (none) align with a local, file-reading tool.
Instruction Scope
Instructions explicitly tell the agent to read ~/.claude/history.jsonl and ~/.claude/projects/*/*.jsonl and to run the included stats.py, which is necessary for the stated purpose. This does mean the skill reads private conversation history (expected for usage statistics) — a privacy consideration but not unexpected. Minor mismatch: SKILL.md mentions session.jsonl path variants while the code processes all *.jsonl under projects; behavior is consistent with broader file discovery.
Install Mechanism
No install spec is provided (instruction-only skill with a bundled script). No downloads, package installs, or external install URLs are present.
Credentials
The skill requests no environment variables or credentials. It does access files under the user's home (~/.claude/*), which is proportional to its function but exposes potentially sensitive conversation history — the code aggregates counts and does not print raw messages, but users should be aware the skill reads local history files.
Persistence & Privilege
always is false and the skill does not request persistent system-wide changes. It does not modify other skills or global agent settings. Autonomous invocation is allowed by default but not combined with other suspicious privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skills-usage - After installation, invoke the skill by name or use
/skills-usage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of skill-usage: analyze and display installed skill usage statistics for a selected time range.
- Collects data from global and project-specific history files, identifying skill calls and their frequencies.
- Presents results in an attractive TUI/Markdown report, including rankings, totals, and bar chart visualizations.
- Supports time period selection (today, past 7/30/90 days, all history) via user prompt.
- Guides execution: runs a stats script with the selected range and outputs the complete report without extra formatting.
Metadata
Frequently Asked Questions
What is Skill Usage?
统计已安装技能在指定时间段内的使用次数，以美观的 TUI 格式展示结果. It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.
How do I install Skill Usage?
Run "/install skills-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill Usage free?
Yes, Skill Usage is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skill Usage support?
Skill Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill Usage?
It is built and maintained by akira82-ai (@akira82-ai); the current version is v0.1.0.
More Skills