Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add basecamp/skills --skill basecamp-doctor -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/basecamp-doctor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/basecamp-doctor/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set3

Project sponsors

Companies that keep this analytics open