clawmetry-selfcheck
GitHub在任务结束前检查ClawMetry遥测数据,识别重复读取、循环执行或预算超支等问题。通过waste、progress和usage命令评估效率,并根据信号调整策略以优化行为。
Trigger Scenarios
Install
npx skills add vivekchand/clawmetry --skill clawmetry-selfcheck -g -y
SKILL.md
Frontmatter
{
"name": "clawmetry-selfcheck",
"description": "Read your own agent telemetry from ClawMetry (waste, progress, cost) and act on it before finishing a task. Use when ClawMetry is installed on this machine and you want to check whether you are re-reading files, spinning in loops, or burning budget."
}
ClawMetry self-check
ClawMetry observes AI agent sessions on this machine (read-only). Use its CLI to see your own telemetry and improve your behaviour mid-task.
All commands are read-only, exit 3 when ClawMetry has no data source
running (safe to skip silently), and support --json.
The 3-step check (run before finishing a task)
# 1. Re-read tax: files you paid to read more than once
clawmetry waste --since 6h --json
# 2. Spinning check: forward progress + loop signals
clawmetry progress --json
# 3. Spend check
clawmetry usage --json
How to act on what you find
| Signal | Action |
|---|---|
A file with reads > 3 in waste |
Stop re-reading it. Write its structure into your working notes once; use offset-ranged reads for big files. |
High ratio (tokens per state-delta) in progress |
You are burning tokens without producing new state. Write down what you tried, change strategy. |
loop_signals non-empty |
You repeated near-identical calls. Do not retry the same thing; diagnose instead. |
Cost spike in usage |
Check usage --by model: are you using a bigger model than the task needs? |
Digging deeper
clawmetry sessions --active # who is running
clawmetry sessions <SID> --transcript # what actually happened
clawmetry sessions <SID> --cost # where the money went (incl. sub-agents)
clawmetry sessions <SID> --errors # error events only
clawmetry activity --follow --max-events 50 # live NDJSON event stream
clawmetry usage --efficiency # A-F efficiency grade
Exit codes: 0 ok, 3 no data source (skip), 4 feature needs an upgrade
(stderr carries a JSON body with upgrade_url; surface it to your human).
Version History
- e0f857b Current 2026-08-02 21:07


