skill-health-scanlisted
Install: claude install-skill Thomaszhou22/skill-health-checkup
# Skill Health Checkup
Your skills fight each other for attention — or never get any. This skill runs a full physical exam on every installed skill and ships one report: who overlaps whom, who is dead weight, who has a broken description.
## Onboarding (First Use)
When the user first triggers this skill and `memory/skill_health_scan_state.json` doesn't exist, run a one-time setup:
1. **Introduce capability** (one sentence): _I can give all yourAllskillscheckup, report_
2. **Quick configuration:**
1. **Report language**(Default: Follow user input language)
- Chinese / English / Follow user input
2. **Fix suggestion mode**(Default: report + )
- Report only (find issues, no file changes)
- Report + suggest fixes (show diff, execute after user confirmation)
3. **Write initial state file** `memory/skill_health_scan_state.json`(JSON format, with `onboarded: true` and timestamp)
4. **Confirm completion**: _"Setup done! Just use it from now on. Say 'reset settings' anytime to reconfigure."
**Onboarding runs exactly once.** Subsequent activations read the state file directly. When the user says "reset settings", delete the state file and re-run setup.
---
## Startup
1. Locate the skills directory (try in order: `~/.openclaw/skills/`, `<project>/.claude/skills/`, `~/.claude/skills/`; if none exists, ask the user where skills live)
2. Run the deterministic scan:
```bash
python3 scripts/scan_skills.py --dir <skills-dir> --json
```
3. Python unavailable → re