- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add basecamp/basecamp-cli --skill basecamp-doctor -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add basecamp/basecamp-cli --skill basecamp-doctor -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add basecamp/basecamp-cli --skill basecamp-doctor -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add basecamp/basecamp-cli --skill basecamp-doctor -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/basecamp/basecamp-cli/tree/HEAD/skills/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. Guard a replacement login
with --expect-identity <id> so a browser signed in as someone else cannot
become the profile. A bot or CI profile that must never sign in interactively
imports a personal access token instead:
op read "op://<vault>/<item>/credential" | basecamp auth login --with-token -P <profile> --account <id> --expect-identity <id>
Check oauth_type before suggesting either. basecamp auth status --json
reports it, and agent means the profile is a Basecamp agent: a principal
with no person behind it, which authenticates with its OAuth client rather
than a sign-in. Both commands above would store a PERSON's credential under
that profile and silently replace the agent. Its remediation is its own
login, with the client secret piped in:
op read "op://<vault>/<item>/credential" | basecamp auth login --with-client-credentials --client-id <id> -P <profile> --account <id>
The CLI's own hint on an agent credential already names this command with
the client id filled in — prefer it verbatim over reconstructing one, and
follow it rather than choosing for yourself whenever oauth_type is absent.
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
Grok skill specifically: basecamp setup grok (skill-only; Grok reads the shared ~/.agents/skills/basecamp skill)
Every remediation above runs without a terminal. Bare basecamp setup is the
human first-time flow and is not one of them: it opens browser OAuth and
refuses with a usage error in machine-output modes or unless stdin, stdout, and
stderr are all terminals. basecamp setup --customize additionally asks the user to
choose each default. Suggest either to a human at a terminal if useful, but
never run them 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.
Diagnose Basecamp CLI, authentication, and agent-plugin health.
---name: basecamp-doctordescription: Diagnose Basecamp CLI, authentication, and agent-plugin health.---# skills/basecamp-doctor/SKILL.md常见问题
从发布者处下载 skills/basecamp-doctor/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/basecamp/basecamp-cli。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。