basecamp-doctor — Claude Code skill: diagnose CLI and authentication
basecamp-doctor runs a diagnostic check on your Basecamp CLI, credentials, and agent integration. Quickly identifies what's misconfigured or needs updating.
no license 325 installs ★ 88 updated 2026-10-24
npx skills add basecamp/skills --skill basecamp-doctor -a claude-codeWhat basecamp-doctor does
The skill executes a structured diagnostic via basecamp doctor --json and reports results by status: pass (working), warn (working but review suggested), skip (not applicable or no permission), fail (needs action). Each result includes a hint and a sequence of remediation commands.
The diagnostic covers authentication (distinguishing between personal accounts and Basecamp agents, which use different credential flows), plugin versions for Codex, Claude Code, Grok, and other agents, and integration health between your IDE and Basecamp. If authentication fails, the skill recommends the correct basecamp auth login command based on profile type. Outdated plugins get a basecamp setup command specific to that component.
All corrections run non-interactively, so they work in CI pipelines or automated scripts. You don't need to manually edit configs; the skill hands you ready-to-run commands like basecamp auth login --with-client-credentials or basecamp setup agents.
What it helps with
- find why Basecamp CLI authentication is failing
- check the installed version of an agent plugin
- diagnose a broken connection between your IDE and Basecamp
- get step-by-step commands to restore your setup
Example prompts for the agent
- Run the diagnostic and show me what's broken
- Check if my Basecamp authentication is valid
- Tell me whether the Claude Code plugin needs updating
How to install basecamp-doctor
1Skills CLI (Vercel)
npx skills add basecamp/skills --skill basecamp-doctor -a claude-code2Manually: put the files in place
~/.claude/skills/basecamp-doctor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/basecamp-doctor/
1Skills CLI (Vercel)
npx skills add basecamp/skills --skill basecamp-doctor -a codex2Manually: put the files in place
.agents/skills/basecamp-doctor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add basecamp/skills --skill basecamp-doctor -a cursor2Manually: put the files in place
.cursor/skills/basecamp-doctor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install basecamp/skills skills/basecamp-doctor2Manually: put the files in place
.github/skills/basecamp-doctor/SKILL.md1Skills CLI (Vercel)
npx skills add basecamp/skills --skill basecamp-doctor -a gemini-cli2Platform CLI
gemini skills install https://github.com/basecamp/skills --path skills/basecamp-doctorManually: put the files in place
.devin/skills/basecamp-doctor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add basecamp/skills --skill basecamp-doctor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about basecamp-doctor
How do I install basecamp-doctor in Claude Code?
Run npx skills add basecamp/skills --skill basecamp-doctor -a claude-code, then verify ~/.claude/skills/basecamp-doctor/SKILL.md. For other platforms, change the -a flag to codex, cursor, gemini-cli, or opencode.
What does basecamp-doctor do?
It runs a diagnostic on your CLI, checks authentication (personal account or agent), verifies plugin versions, and tests agent integration. If it finds issues, it outputs ready-to-run commands to fix them.
How does authentication differ for personal accounts and Basecamp agents?
Personal accounts sign in via basecamp auth login (opens a browser). A Basecamp agent is a service principal without a person; it authenticates with basecamp auth login --with-client-credentials, passing the client secret.