# basecamp-doctor

basecamp-doctor runs a diagnostic check on your Basecamp CLI, credentials, and agent integration. Quickly identifies what's misconfigured or needs updating.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 325 installs · ★ 88 repo stars
- Author: basecamp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basecamp/skills/tree/HEAD/skills/basecamp-doctor/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/basecamp-doctor

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill basecamp-doctor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/basecamp-doctor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/basecamp-doctor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill basecamp-doctor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/basecamp-doctor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill basecamp-doctor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/basecamp-doctor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install basecamp/skills skills/basecamp-doctor
```

2. **Manually: put the files in place**
- File: `.github/skills/basecamp-doctor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill basecamp-doctor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/basecamp/skills --path skills/basecamp-doctor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/basecamp-doctor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add basecamp/skills --skill basecamp-doctor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/basecamp/skills/tree/HEAD/skills/basecamp-doctor/SKILL.md

## When to use it
- 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
- 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

## Similar
- [ruflo-doctor](https://affpapa.org/en/nevibecode/skills/ruflo-doctor.md) — skill · 755 installs
- [basecamp-automation](https://affpapa.org/en/nevibecode/skills/basecamp-automation.md) — skill · ★ 3785 repo stars
- [ctx-doctor](https://affpapa.org/en/nevibecode/skills/ctx-doctor.md) — skill · 1800 installs
- [omc-doctor](https://affpapa.org/en/nevibecode/skills/omc-doctor.md) — skill · 913 installs
- [skill-doctor](https://affpapa.org/en/nevibecode/skills/skill-doctor.md) — skill · 15 installs
- [install-doctor](https://affpapa.org/en/nevibecode/skills/install-doctor.md) — skill · ★ 33 repo stars

From the same set: [basecamp/skills](https://affpapa.org/en/nevibecode/by/basecamp/skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
