/basecamp-doctor
Diagnose Basecamp CLI, authentication, and agent-plugin health.
$ npx -y skills add basecamp/basecamp-cli --skill basecamp-doctor --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/basecamp-doctor
Context preview
The summary Claude sees to decide when to auto-load this skill.
Diagnose Basecamp CLI, authentication, and agent-plugin health.
SKILL.md
basecamp-doctor.SKILL.mdname: basecamp-doctor description: Diagnose Basecamp CLI, authentication, and agent-plugin health.
Basecamp Doctor
Run the structured diagnostic:
basecamp doctor --json
Interpret every check by status:
- `pass`: working correctly.
- `warn`: usable, but follow-up is recommended.
- `skip`: not run because it is unauthenticated or not applicable.
- `fail`: broken and needs attention.
Report failures and warnings with their `hint` fields. Also inspect the top-level `breadcrumbs` array and preserve its structured `cmd` next steps, because a breadcrumb can provide a more specific action than a check hint. Use these common remediations when relevant:
- Basecamp authentication: `basecamp auth login`
- Agent plugin installation or version: `basecamp setup`
- Skill + all detected agents, non-interactively: `basecamp setup agents` (honors `BASECAMP_SETUP_AGENT`)
- Codex plugin specifically: `basecamp setup codex`
- Claude Code plugin specifically: `basecamp setup claude`
Do not read, print, or request credential files. If every check passes, say that Basecamp and its agent integration are ready.
basecamp is the official command-line interface for Basecamp. Manage projects, todos, messages, and more from your terminal or through AI agents.
Repo: basecamp/basecamp-cli