Install
$ agentstack add skill-yctimlin-agent-usage-analyzer-agent-usage-analyzer ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Agent Usage Analyzer
Goal
Produce an accurate, local, read-only report of structured skill, tool, command, and MCP usage across agent sessions.
Inputs to infer from the user's request
- agent or source filters
- since and until date filters
- repo or cwd filters
- raw versus canonical mode
- kind filter
- output format
- whether the user supplied an export directory
- whether samples, partial sessions, or heuristic parsing are allowed
Resources
- Analyzer script:
scripts/analyze.mjs - Install helper:
scripts/install.mjs - Output contract:
references/OUTPUT.md - Alias example:
references/ALIASES.example.yaml
Workflow
- Do not count usage manually from transcript prose.
- Prefer running
scripts/analyze.mjs. - Use
--provider autounless the user supplied an explicit export directory. - If the user asks for "skill usage", "agent skills", or named skill counts, prefer
--kind skill. - For Codex and Claude Code event-log exports, count skill usage from structured
.../skills//SKILL.mdload signals rather than generic transport tools. - If the source only exposes tool or MCP events and does not expose any structured skill-load signal, say so explicitly instead of presenting tool counts as skill counts.
- If the analyzer reports missing prerequisites, explain what is missing instead of guessing.
- Present the result as a markdown table unless the user asked for JSON or CSV.
- Always state coverage and caveats.
Output rules
- Treat
skill,tool,command, andmcpas separate categories unless the user asks for a broader combined report. - Default to canonical mode.
- Use raw mode only when the user asks for raw names.
- Keep samples off unless the user asks for them.
- Sort rows by invocation count descending.
- Never imply skipped sessions were counted.
- When reporting skill usage from Codex or Claude Code archives, note that counts come from structured skill-load records, typically reads or prompts that reference
SKILL.md.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: yctimlin
- Source: yctimlin/agent-usage-analyzer
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.