skillshub doctor

The doctor command runs a series of health checks on your skillshub installation and reports any issues it finds.

Usage

skillshub doctor

What it checks

Check	Description
Git availability	Verifies that `git` is installed and reports its version.
Clone integrity	Ensures each tap’s local clone is a valid git repository with a reachable remote.
Skill files	Scans for missing or malformed `SKILL.md` files in tap clones.
Orphan detection	Identifies installed skills whose source tap has been removed.

Example

skillshub doctor

✓ git available (2.44.0)
✓ 2 taps healthy
✓ 6 skills installed, 0 orphaned

If issues are found, doctor provides actionable suggestions:

✓ git available (2.44.0)
✗ anthropics/skills — clone corrupt, run: skillshub tap update anthropics/skills
✓ 1 tap healthy
⚠ 1 orphaned skill: old-tap/legacy-skill (source tap removed)

When to use it

After upgrading skillshub to a new version.
If tap update or install produces unexpected errors.
To verify everything is healthy after a system migration.