---
name: skillnote-doctor
description: "A diagnostic tool for OpenClaw agents -- checks skill registry connectivity, AGENTS.md setup, config file validity, and installed skill health. Use when your setup seems broken, skills aren't loading, or you want to audit your agent's configuration."
version: "1.0.1"
metadata: {"openclaw": {"emoji": "🩺", "triggers": ["diagnose", "check setup", "why isn't", "debug", "broken", "not working"]}}
---

# SkillNote Doctor

Diagnose your SkillNote + OpenClaw integration in 6 checks. Run every check even if an earlier one fails — the user needs the full picture. Report ✓ pass or ✗ fail with specific remediation for each.

## Check 1 — clawhub binary

Run: `which clawhub`

- ✓ Pass: binary found
- ✗ Fail: `clawhub not found. Install from https://clawhub.ai or run: npm install -g clawhub`

## Check 2 — SkillNote config

Read `~/.openclaw/skills/skillnote/config.json`.

- ✓ Pass: file exists, valid JSON, `host` is non-empty
- ✗ Fail (missing): `Config not found. SkillNote is not installed. Install with: clawhub install skillnote && clawhub install skillnote-resolver`
- ✗ Fail (invalid JSON): `Config is malformed. Delete ~/.openclaw/skills/skillnote/config.json and re-run skillnote setup.`
- ✗ Fail (empty host): `Config exists but host is empty. Ask your agent to re-setup skillnote.`

## Check 3 — Registry reachability

GET `<host>/v1/skills?limit=1`

- ✓ Pass: HTTP 200
- ✗ Fail (timeout/refused): `SkillNote at <host> is unreachable. Verify the URL and that your instance is running. Self-host guide: https://github.com/luna-prompts/skillnote`
- ✗ Fail (non-200): `Unexpected HTTP <N>. Check SkillNote server logs.`

## Check 4 — AGENTS.md marker

Read `~/.openclaw/workspace/AGENTS.md`. Check for exact string `<skillnote v1>`.

- ✓ Pass: marker found
- ✗ Fail: `AGENTS.md marker missing. Ask your agent: "re-graft skillnote into AGENTS.md" — or reinstall: clawhub install skillnote`

## Check 5 — skillnote-resolver installed

Check `~/.openclaw/skills/skillnote-resolver/SKILL.md` exists.

- ✓ Pass: file found
- ✗ Fail: `skillnote-resolver not found. Install with: clawhub install skillnote-resolver`

## Check 6 — resolver endpoint

POST `<host>/v1/openclaw/context-bundle` with body `{"task_summary": "doctor health check", "max_skills": 1}`

- ✓ Pass: HTTP 200, `skills` array present
- ✗ Fail: `Context bundle endpoint unavailable. Check SkillNote server version — endpoint requires v0.3.0+`

---

## Summary

After all checks report:

```
SkillNote health: X/6 checks passed
```

If all 6 pass:
> Your SkillNote integration looks healthy. If you're still seeing issues, check https://github.com/luna-prompts/skillnote/issues

If Check 2 fails with "Config not found" (SkillNote not installed at all):
> SkillNote not detected. Install with:
> ```
> clawhub install skillnote
> clawhub install skillnote-resolver
> ```
> Then follow the 5-step setup that runs automatically on first load.

---

# Hard rules

- Never modify any file during diagnosis — read-only.
- Never POST to any endpoint other than `/v1/openclaw/context-bundle`.
- Run all 6 checks regardless of earlier failures.
- Never guess or invent the host URL — read it strictly from config.json.