feat(cli): add a doctor command that checks the setup before a paid run
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 15/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- bash, docker, go, nodejs
- Domain
- cli, developer-experience
Research direction
This is a cross-cutting design task across the Go CLI. Start with the static preflight from #233 and the validate command, then read internal/agent/claude_code.go and internal/judge/script.go to see how credentials and script judges run. Done means skill-up doctor prints an ok, warn or fail line per check, exits non-zero on failure, and supports --json, with the design agreed in the thread first.
Written by the indexing model from the issue text.
Description
Problem / motivation
First runs often fail on environment details, and users find them one at a time in issue threads, after starting a run. Windows shows it most:
- #160: tokens always 0.
- #279: "不支持window?" (is Windows not supported?).
- #292: MSYS2 truncates long arguments, root-caused by the reporter.
- #354: a junction
TEMP, then an OpenCodePWDproblem.
skill-up already has a static preflight (#233) and credential checks, but they run only inside run, and validate checks the files, not the machine.
Proposed solution
skill-up doctor [evals/eval.yaml]. It makes no model calls and prints one line per check, each as ok, warn or fail, with a fix hint:
- Runtime: for
none, the shell skill-up will use. Fordocker, the daemon is reachable. Foropensandbox, the endpoint answers. - Engine: the CLI is found, and its version is shown next to the version skill-up installs by default. On
nonethis is the host; on Docker and OpenSandbox, the check reports what setup will install rather than probing the host. - Credentials: report which of three states applies, without printing a value: credentials injected from config or the environment, a local CLI login detected, or a login that cannot be confirmed without a model call. The last is a warning, not a failure, since Claude Code and Codex deliberately run on an existing login when no key is set (claude_code.go#L108).
- Tools the suite needs, where they will run:
nodefor mocked MCP servers and the interpreters script judges need. Script judges run in the case runtime (script.go#L117), so onnonethis checks the host, and on a container runtime it checks the image or setup steps. - Windows: the Bash that will be used (
SKILL_UP_BASH), the temp folder, and known path problems. - With an eval path: the result of
validatefor that suite.
Add --json output, and a non-zero exit when any check fails, so CI and skill-upper can call it before spending tokens.
Alternatives considered
validateplus--dry-run. Neither checks the engine, the credentials or the host.- A troubleshooting page in the docs. It helps, but users still find their problem by trial.
Additional context
- #233 added the static runtime preflight that
doctorcan reuse. - #281 and #287 check the Skill's content. This issue checks the machine.
- #48 covers Windows end-to-end coverage for the agent CLIs.
- Dominant language
- Go
- Stars
- 1.5k
- Forks
- 134
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 61
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from alibaba/skill-up
-
Difficulty 5/5 Over a week Newbie friendliness 35/100
Maintainers usually reply within 1 day
-
OpenSandbox runtime: expect.files_exist and file_contains fail because WorkspacePath is remotePossibly taken @bababoom721 claimed this 1 day ago. Open
Difficulty 4/5 3-5 days Newbie friendliness 25/100
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 30/100
alibaba/skill-up#408 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 25/100
alibaba/skill-up#406 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 4/5 3-5 days Newbie friendliness 30/100
alibaba/skill-up#405 · 1 comment ·
Maintainers usually reply within 1 day
All issues in alibaba/skill-up
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
OneBusAway/maglev#2145 ·
Maintainers usually reply within 2 days
-
priority/medium status/ready type/chore
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
discobox-ai/discobox#1357 ·
Maintainers usually reply within 1 day
-
TestPseudoLocaleRemote fails now and then: it types the code before the laptop asks for itPossibly taken @fzn0x claimed this today. Openbug priority: low
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
Maintainers usually reply within 1 day
-
edit_file diff rendering panics on invalid UTF-8 textPossibly taken @TDnorthgarden claimed this today. Openarea/tui
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
docker/docker-agent#4955 ·
Maintainers usually reply within 1 day
-
enhancement ui/ux
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
jbigler/railswitch#243 ·
Maintainers usually reply within 1 day