Skill monitor

Skill wei63w/skill-monitor/skills/skill-monitor

Monitor local Agent Skill usage, Rules/AGENTS.md context bloat, and Task / sub-agent startup cost (starts × system-prompt volume). Use for skill frequency, skill token estimates, unused skills, context bloat, AGENTS.md / rules size, subagent cost, backfill from transcripts, or project skill tracking. Also use for skill 监控, skill 统计, skill 频率, Rules 膨胀, AGENTS.md 体积, 子 Agent / Task 成本.From its SKILL.md

Install

npx -y skills add wei63w/skill-monitor --skill skill-monitor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.6 KB, 586 tokens by cl100k_base, as published. Nobody here has run it

Skill Monitor

Track skill usage, always-on context bloat, and sub-agent startup cost in the project-local data/ directory. Capture is best-effort.

Quick setup

node .cursor/skills/skill-monitor/scripts/cli.mjs setup --project . --hooks
node .cursor/skills/skill-monitor/scripts/cli.mjs backfill
node .cursor/skills/skill-monitor/scripts/cli.mjs backfill-tasks
node .cursor/skills/skill-monitor/scripts/cli.mjs analyze --project . --write
node .cursor/skills/skill-monitor/scripts/cli.mjs bloat --project . --snapshot --write
node .cursor/skills/skill-monitor/scripts/cli.mjs analyze-tasks --project . --write

setup --hooks installs:

beforeReadFile → record SKILL.md loads
subagentStart + preToolUse (Task) → record sub-agent starts with Rules/AGENTS volume

Commands

Command	Purpose
`setup [--hooks]`	Init `data/`; merge Cursor hooks
`record --path <SKILL.md>`	Record one skill use
`analyze [--write]`	Skill frequency + est. tokens
`bloat [--snapshot] [--write]`	Rules / AGENTS.md bloat + budgets
`record-task --type <name>`	Record one Task / sub-agent start
`analyze-tasks [--write]`	Startup cost: starts × avg prompt volume
`backfill`	Skills from Cursor transcripts
`backfill-tasks`	Task/subagent starts from transcripts
`reestimate`	Refresh skill `estTokens`
`list-skills` / `summary`	Discovery / aggregates

Data layout

data/events.jsonl — skill loads (estTokens)
data/summary.json — skill aggregates
data/tasks.jsonl — sub-agent starts (systemPromptTokens)
data/context-snapshots.jsonl — optional bloat history
data/report.md / bloat-report.md / tasks-report.md

Agent workflow

Skill stats → analyze --write
Context inflation → bloat --snapshot --write
Sub-agent cost → analyze-tasks --write (after hooks or backfill-tasks)
Mention limits: estimates are not provider billing; hooks are strongest in Cursor.

Manual fallbacks

node .cursor/skills/skill-monitor/scripts/cli.mjs record --path "C:/path/to/skill/SKILL.md"
node .cursor/skills/skill-monitor/scripts/cli.mjs record-task --type explore --project .

Skill monitor

One thing to look at

SKILL.md

Skill Monitor

Quick setup

Commands

Data layout

Agent workflow

Manual fallbacks

What ships with it: 13 files

data/

scripts/

Keep looking