shipables doctor

Run health checks on your installed skills to verify everything is set up correctly.

Usage

shipables doctor [options]

Options

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