basecamp-doctor

A diagnostic workflow for the Basecamp command-line tool and its agent plug-ins. It checks authentication, installation, versions, and overall setup, then explains warnings or failures.

In plain words
What is it for?
Use it to troubleshoot Basecamp login issues, agent-plugin setup, or Codex and Claude Code integration.
Why use it?
It turns a vague setup problem into specific checks and suggested next actions.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/basecamp/basecamp-cli/basecamp-doctor
Any agent
npx skills add basecamp/basecamp-cli --skill basecamp-doctor
Clone the repo
git clone --depth 1 https://github.com/basecamp/basecamp-cli

Made for: Claude Code, Codex.

Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 318 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00018 $0.00318
Opus 5 $0.00009 $0.00159
Sonnet 5 $0.00004 $0.00064
Haiku 4.5 $0.00002 $0.00032

Measured 2d ago against content hash 3da7cddc473f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

basecamp-doctor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/basecamp-doctor/SKILL.md · 35 lines

What it actually says

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 agents (honors BASECAMP_SETUP_AGENT)
  • Codex plugin specifically: basecamp setup codex
  • Claude Code plugin specifically: basecamp setup claude

Every remediation above runs without a terminal. Bare basecamp setup is the interactive first-run wizard and is not one of them: it is prompts end to end, so it refuses with a usage error in machine-output modes or when stdin and stderr are not both terminals. Suggest it to a human at a terminal if you like, but never run it yourself — use the subcommands above.

Do not read, print, or request credential files. If every check passes, say that Basecamp and its agent integration are ready.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 35 lines · 18 tokens per session scan A 3da7cddc473f

Subscribe to this mod's changes

basecamp-doctor is a skill published in the GitHub repository basecamp/basecamp-cli (259 stars, last pushed 3d ago), licensed MIT. It adds 18 tokens to every session and 318 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

svg-builder

Build correct, self-contained SVG diagrams, illustrations, and animations from a description. Everything it produces moves by default -- flow along the edges, a staged reveal, a state change -- with a resting state that still reads on its own. Use this skill whenever the user asks for a diagram, flowchart…

nguyenvanphituoc/shapeup-sdlc-plugin · 212 tokens

shapeup

Use this skill for any Shape Up workflow before writing code. Triggers on: "shape this feature", "frame this problem", "breadboard this", "map affordances", "write a framing doc", "write a kickoff doc", "turn this transcript into a framing document", "turn this transcript into a kickoff document", "what should we…

nguyenvanphituoc/shapeup-sdlc-plugin · 217 tokens

spec-evaluator

Use this skill whenever the user wants to evaluate, QA, or verify that an implemented task actually matches its spec and acceptance criteria — the judge in a planner→generator→evaluator harness. Trigger on: "evaluate task TASK-NNN", "QA TASK-NNN", "verify against spec", "check acceptance criteria", "does this match…

nguyenvanphituoc/shapeup-sdlc-plugin · 117 tokens

architecture-research-report

Research a technical question deeply, then produce an evidence-dense architecture report that takes a position, shows its work, and carries Mermaid diagrams and comparison tables. Writes as a solution/systems architect and senior AI/data engineer would: leads with the finding, grounds every claim in a citable source…

nguyenvanphituoc/shapeup-sdlc-plugin · 240 tokens

harness-maintenance-audit

Audit this plugin repo for two kinds of rot: documentation that no longer matches the shipped plugin, and internal bookkeeping that has leaked into files users receive. Derives every fact from the artifact itself — enums from the schema, counts from the filesystem, hook behavior by executing the hook — then fixes the…

nguyenvanphituoc/shapeup-sdlc-plugin · 212 tokens

ba-pitch-analyzer

Use this skill whenever a user provides a product requirement, pitch, or feature description and wants it broken down into structured, executable development tasks. Triggers on: "analyze this pitch", "break this into tasks", "generate tasks from requirement", "act as BA", "create spec from PRD", "turn this into dev…

nguyenvanphituoc/shapeup-sdlc-plugin · 142 tokens