ClawHub

Clawdoc

v0.12.0

Diagnose OpenClaw agent failures, cost spikes, and performance issues with 14 pattern detectors. Use when: task failed unexpectedly, costs seem high, agent b...

⭐ 0· 115·0 current·0 all-time
byAshish Jain@ashishjaingithub
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description match the requested binaries (bash, jq, bc) and the provided scripts implement 14 detectors for JSONL agent sessions. Nothing requested (no cloud credentials, no unusual binaries) appears unrelated to a local diagnostics tool.
✓
Instruction Scope
SKILL.md instructs running local scripts against explicit session JSONL files or a user-provided sessions directory. The tool only reads session files, produces JSON findings, and — only if opt-in via CLAWDOC_LEARNINGS=1 — writes a local .learnings/LEARNINGS.md file. There are no instructions to contact external endpoints, harvest unrelated config, or automatically search system paths without explicit user input. Note: helper/dev scripts (e.g., convert-claude-sessions.sh) will scan an input directory you provide and may run find/grep on paths you pass — review the path you give to avoid scanning sensitive large trees.
✓
Install Mechanism
No install spec is provided (instruction-only install), and there are no downloads or remote installers referenced. Code is shipped as shell scripts in the package; risk is limited to running those scripts locally. No extract-from-URL or third-party package installs are present.
✓
Credentials
The skill requires no environment variables or credentials to run. The only optional environment flag (CLAWDOC_LEARNINGS=1) enables a local write to .learnings/LEARNINGS.md and is opt-in. No secrets or unrelated environment/config paths are requested.
✓
Persistence & Privilege
always is false and the skill is user-invocable. It does not request persistent platform privileges or modify other skills. The only persistence is an opt-in local write when CLAWDOC_LEARNINGS is set; scripts otherwise operate on files you explicitly pass.
Assessment
This appears to be a legitimate local diagnostics skill. Before running it: (1) Inspect the scripts (they are plain shell + jq) and confirm you trust them in your environment. (2) Run the demo (generate-demo.sh) to see behavior on synthetic data. (3) When diagnosing real sessions, supply explicit paths (avoid passing / or other broad roots to convert or headline scripts). (4) Only set CLAWDOC_LEARNINGS=1 if you want findings written into a local .learnings/LEARNINGS.md file. (5) Ensure dependencies (jq, bash, bc) are installed and run the test suite (make test) if you want extra assurance.

Like a lobster shell, security has layers — review code before you run it.

agent-healthvk977kw8n3d52v44jrt8rfjb4yh8336ytcost-optimizationvk977kw8n3d52v44jrt8rfjb4yh8336ytdebuggingvk977kw8n3d52v44jrt8rfjb4yh8336ytdiagnosticsvk977kw8n3d52v44jrt8rfjb4yh8336ytlatestvk97d4wtv3eng1fq6hmay1wsae98351c8observabilityvk977kw8n3d52v44jrt8rfjb4yh8336yt

License

MIT-0
Free to use, modify, and redistribute. No attribution required.
Termshttps://spdx.org/licenses/MIT-0.html

Runtime requirements

🩻 Clawdis
Binsjq, bash, bc

Comments