skills-doctor

Diagnose missing dependencies that break installed agent skills on a machine.

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/thititongumpun/skills --skill skills-doctor-thititongumpun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skills-doctor
Source: https://github.com/thititongumpun/skills/tree/main/skills/skills-doctor
Command: npx skills add https://github.com/thititongumpun/skills --skill skills-doctor-thititongumpun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? After installing a set of agent skills, some silently fail because required binaries, plugins, or third-party skills are missing. This Skill audits the machine and reports per skill which dependency is dead or degraded, with the exact install command for each gap. ## Core Features & Use Cases - Per-skill dependency report: Probes binaries (curl, docker, officecli, jq, python3), plugins (superpowers, context7), and routed third-party skills (archify, ppt-master), classifying each as dead, degraded, or OK. - Safe fix mode: --fix offers to run only user-prefix package manager installs (brew, npm -g, scoop, uv tool) one y/N prompt at a time; anything needing sudo, a curl-pipe, or a slash command is printed for the user to run. - Hook mode: --skills runs silently on session start when all routed third-party skills are present, and exits 2 naming each missing one with its install line. - Use Case: After a fresh install, run the doctor to learn that mfec-pptx-diagram is dead because officecli is missing, and get the exact npm install -g @officecli/officecli command. ## Quick Start Ask the agent to run the skills doctor and tell you which skills are broken on this machine and what to install.

Frequently Asked Questions about skills-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check which agent skills are broken on my machine?

Run scripts/doctor.sh from the skills-doctor directory. It probes each required binary and plugin, then prints a DEAD section for skills that cannot run and a DEGRADED section for skills with reduced functionality, each with the exact install command.

How do I automatically fix missing skill dependencies?

Run doctor.sh with the --fix flag. It offers to run only safe user-prefix installs like brew, npm -g, scoop, and uv tool, prompting y/N for each. Commands needing sudo, curl pipes, or /plugin install are printed for you to run manually.

Can a shell script check Claude Code tools like subagents or AskUserQuestion?

No, a shell cannot see Claude's tool list, so subagents, AskUserQuestion, TodoWrite, Artifact, and WebFetch are not probed. Run /skills-doctor inside Claude Code to have the harness-side tools checked from the agent's own tool list.

Why does skills-doctor exit with code 1 or 2?

Exit code 1 means at least one hard dependency is missing and a skill is dead; exit 0 means nothing is dead. In --skills hook mode, exit code 2 signals that third-party skills this repo routes to are missing, with their install lines printed.

Does skills-doctor install anything without asking?

No. It never installs anything on its own. Even with --fix, it prompts before each safe command, and with no terminal available it prints every command and runs nothing.