0.2.0 — 2026-06-15

Release Notes

• Scope picker (--scope project|all|user): auto-detected as project when the repo has a .claude/skills dir; otherwise all; p key in the TUI cycles scopes live.
• Project lens (--lens project|global): filters usage heat to the current project root; L key in the TUI toggles the lens.
• Disabled-plugin awareness: skills turned off via enabledPlugins are flagged off in both the overview source column and the detail view, and excluded from the always-on total.
• Honest cost split: every skill reports always_on (loaded every session) and on_fire (loaded only when invoked) token costs separately; the overview footer shows the always-on total.
• History as second usage source (history.jsonl): Claude Code's typed-command log is parsed as a parallel signal. Doctor finding W010 fires when a skill appears in history but has zero transcript usage, flagging likely transcript rotation or a wrong --projects-dir.
• --projects-dir / --config-dir decoupled: the two roots are now independent flags; --projects-dir defaults to ~/.claude/projects while --config-dir stays at ~/.claude.
• Walk-up boundary fix: project-scope discovery walks up from cwd collecting .claude/skills dirs, stopping at the first .git ancestor (inclusive); prevents leaking skills from outside the repo into project scope.

Install skillhealth 0.2.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mirko-pira/skillhealth/releases/download/v0.2.0/skillhealth-installer.sh | sh

Install prebuilt binaries into your npm project

npm install skillhealth@0.2.0

Download skillhealth 0.2.0

File	Platform	Checksum
skillhealth-aarch64-apple-darwin.tar.xz	Apple Silicon macOS	checksum
skillhealth-x86_64-apple-darwin.tar.xz	Intel macOS	checksum
skillhealth-x86_64-pc-windows-msvc.zip	x64 Windows	checksum
skillhealth-aarch64-unknown-linux-gnu.tar.xz	ARM64 Linux	checksum
skillhealth-x86_64-unknown-linux-gnu.tar.xz	x64 Linux	checksum