Check the health of installed skills and agent configurations.
shipables doctor
Run health checks on your installed skills to verify everything is set up correctly.
Usage
shipables doctor [options]
Options
| Flag | Description |
|---|---|
-g, --global | Check globally installed skills |
What it checks
For each installed skill, the doctor command verifies:
- Skill directory exists — The skill files are where they should be
- SKILL.md is present — The core skill file exists in the directory
- MCP configuration — If the skill declares MCP servers, checks that the entries exist in the agent's config file
- Available updates — Checks the registry for newer versions
Example
$ shipables doctor
Checking installed skills...
Chippers255/ai-commits@1.0.0 (claude, cursor)
✓ Skill directory exists (.claude/skills/ai-commits)
✓ SKILL.md found
✓ MCP server configured
⚠ Update available: 1.2.0 → 1.3.0
postgres@2.0.0 (claude)
✓ Skill directory exists (.claude/skills/postgres)
✓ SKILL.md found
✓ No MCP servers
✓ Up to date
Summary: 2 skills checked, 0 issues, 1 update available
When to use
Run shipables doctor when:
- A skill isn't working as expected
- You've manually moved or edited config files
- You want to check for available updates
- After upgrading your AI agent