mrkeyoor.com_
Sun 27 Sept 19:23 UTC
Automationevaluationupdated 26 Aug 2026

skill-up review

skill-up is a command-line evaluator for Agent Skills, including skills used by Claude Code, Codex, Qoder CLI, and Qwen Code. It runs YAML-defined cases, grades the results, produces local or CI reports, and ships a companion skill that can revise a skill or its eval suite after failures.

+69stars / 7d
Verdict

Our npm run installed 150 packages in 35 seconds, but the package exposed no build or test target, so it did not verify the Go evaluator. skill-up is worth adopting when Agent Skills already affect real work and failures need to become repeatable regression cases across several clients. Start with a small deterministic suite, then add model judges carefully, especially across Codex and Anthropic protocols.

We ran it

Lab card: what happened when we ran skill-upScreenshot of skill-up (alibaba.github.io/skill-up)
Install✓ · 35s150 packages · 95 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo450 files~70,817 lines of source · 6.2 MB · 9 CI workflows

Answers from our run

Does skill-up build from source?

Dependencies installed in 35 seconds (150 packages), and the project has no separate build step. We cloned commit 8566175 into a clean Debian container with 3 CPUs and no project-specific setup.

Does skill-up have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does skill-up have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use skill-up?

Teams expecting a credential-free evaluator: real agent runs need the chosen engine CLI, model access, and provider credentials.

What are the alternatives to skill-up?

promptfoo, Anthropic Skills. Our npm run installed 150 packages in 35 seconds, but the package exposed no build or test target, so it did not verify the Go evaluator.

Setup3/5Docs install passed; real evals need Go or CLI plus agent credentials
Docs5/5English and Chinese manuals cover cases, engines, CI, and Windows
Community4/5726 stars, current pushes, and active issue and pull request work
Maturity3/5v0.9.1 has broad machinery, with cross-engine gaps still open

Discussed on

  1. hnShow HN: Skill-up – Regression testing for Agent Skills5 points

Who it’s for

Agent Skill authors who need repeatable cases and regression reports instead of judging prompts by feel.
Teams comparing the same skill across Claude Code, Codex, Qoder CLI, or Qwen Code.
CI owners who want rule, script, or model-based judges with JSON, JUnit, Markdown, and HTML output.
Platform engineers integrating an internal agent through a local command or HTTP endpoint.

Who it’s NOT for

Teams expecting a credential-free evaluator: real agent runs need the chosen engine CLI, model access, and provider credentials.
Windows users who want the full built-in agent workflow directly under cmd.exe: the Windows guide recommends WSL2 because the Node and nvm bootstrap is Bash-based.
Codex evaluations that pin an Anthropic judge today: issue 104 reports that the judge inherits the case engine and fails across those protocol boundaries.
Anyone who wants a tiny prompt-test script: the repository has 450 files, about 70,817 source lines, multiple report formats, runtimes, telemetry support, and CI machinery.

Setup reality

Our npm sandbox install succeeded in 35 seconds, adding 150 packages and using 95 MB. There was no npm build script or test script, so both steps were skipped. Npm audit reported 0 known vulnerabilities.

That npm package builds the VitePress documentation, not the Go CLI. The actual command-line tool needs Go 1.25 when built from source, or the provided installer. Real evaluations also need an agent CLI, model credentials, an eval suite, and sometimes OpenSandbox or an HTTP agent service.

The checkout had 9 CI workflow files, no Dockerfile, and no tests directory according to our scan. The GitHub Action runs only on Linux and uses a separately built runner image with a pinned CLI; native Windows agent execution has documented Bash and path constraints.

YAML cases turn Skill behavior into a repeatable check

The 450-file skill-up repository gives Agent Skill authors a test harness built around eval.yaml and case files. Each case describes the environment, engine, model, inputs, and judging method. The runner creates a workspace, installs the Skill, invokes the selected agent, grades the result, and writes structured output. This makes a failed behavior reproducible in CI instead of leaving it as a transcript someone has to interpret by eye.

Its roughly 70,817 source lines support rule-based checks, scripts, and an agent_judge. Reports include result.json, Anthropic-compatible grading and benchmark files, JUnit XML, Markdown, and HTML. It can also import Anthropic-style evals.json. Benchmark mode runs cases with and without the Skill, which is useful when a plausible-looking skill makes the underlying agent worse on tasks it already handled.

Four built-in engines expose portability problems early

The 450-file checkout lists Claude Code, Codex, Qoder CLI, and Qwen Code as built-in engines. A custom engine can run as a local command or accept an HTTP request, using a documented session input and result contract. That range lets one suite test whether a Skill depends on one client's tool naming, transcript format, installation path, or model protocol.

Cross-engine judging is not settled in every combination. Open issue 104 reports that an agent_judge inherits the case engine even when its configured model belongs to another provider. The reported Codex case works with an OpenAI-protocol judge and fails with an Anthropic judge. Until that issue is resolved, keep the judge compatible with the evaluation engine or validate the exact pairing before relying on its grade.

What happened when we ran it

Our sandbox installed 150 npm packages in 35 seconds and consumed 95 MB on disk. Npm audit reported 0 known vulnerabilities. The package exposed neither a build script nor a test script, so those steps were skipped. This is an important boundary: the root npm package is the VitePress documentation site, while the evaluator itself is written in Go.

commit 8566175 contained about 70,817 source lines in a 6.2 MB checkout. Our scan found 9 CI workflow files, no Dockerfile, and no tests directory. Those signals describe the repository layout seen by the harness; they do not replace executing the Go test commands or the model-backed end-to-end cases. We did not run either through the npm project, and the review should not imply otherwise.

Our measurement setup was an unprivileged Debian container with 3 CPUs, 8 GB of RAM, Node.js 22, and no secrets. It confirms that the docs dependency tree installs cleanly at the measured commit. It says nothing about the quality of a model judge, the behavior of an external agent CLI, or the availability of a configured OpenSandbox service.

Go 1.25 builds the CLI, while real evals need agent access

The Go module declares Go 1.25. Users can install a release through the provided shell installer, or let the bundled skill-upper Skill guide an agent through installation. A useful run still needs more than the binary: an Agent Skill, realistic cases, the chosen client, model credentials, and judges that can make a clear pass or fail decision. An OpenSandbox runtime adds its own service endpoint and runtime settings.

Configuration has 4 precedence layers: embedded defaults, a user file, a project file, and an explicit path. Existing environment variables win over values supplied by configuration. The docs recommend environment references for secrets, but also state that the current user-config fields do not carry redaction tags. Teams exporting OpenTelemetry data should review what they set and where credentials appear before sharing configs or reports.

The v0.9.1 Linux action pins a separate runner image

The v0.9.1 repository includes a Docker-based GitHub Action for Linux runners. It can select an engine, provider, model, API key, target suite, and parallelism. Its runner image prebuilds the CLI and 3 agent clients, and the production action is supposed to reference that image by immutable digest. A release tag captures the action file present at that commit, but publishing a CLI release does not automatically rebuild the runner image.

That split affects reproducibility. The documentation tells maintainers to synchronize the pinned CLI version and publish a tested image manually. Users who want a fixed setup should choose a post-refresh commit SHA rather than assume a CLI tag contains an image with the same version. The v0.9.1 release included fixes around Codex JSONL, Qoder token handling, Windows PowerShell, judges, and report metrics.

Windows runs the Go 1.25 CLI, but WSL2 is the full-agent path

The Windows guide says Go builds, unit tests, the host runtime, and script judges can run natively. PowerShell and batch judges have direct paths, while shell judges need Git Bash. The WSL bash.exe shim is rejected because its Linux paths do not match the Windows paths generated by skill-up. For a remote OpenSandbox Linux guest, the host communicates over HTTP and avoids the local shell mismatch.

Built-in agent clients have a harder limitation: their Node and nvm bootstrap is Bash-based. The docs recommend WSL2 for full Claude Code, Codex, or Qoder evaluations when the agent CLIs are not already installed. The last push was August 26, 2026, six days after v0.9.1, and GitHub listed 726 stars with 16 open issues and pull requests. Maintenance is current, while the open protocol and Windows work shows where adopters should test first.

Alternatives

ProjectWhat it isPick it when
promptfoo gh↗A general-purpose command-line framework for testing prompts, models, agents, and red-team cases.pick this instead when your evaluation target is broader than Agent Skills or your team already uses promptfoo assertions.
Anthropic Skills gh↗Anthropic's public collection of skill examples and skill-authoring resources.pick this instead when you need examples and authoring guidance before you need a multi-engine evaluation runner.

What people are saying

  1. [github-trending] alibaba/skill-up

Sources

  1. skill-up README
  2. skill-up v0.9.1 release
  3. Windows support guide
  4. Cross-provider agent judge issue

More automation reviews

runner-images · agent-fleet-manager · kargo · Rose · alchemy · laya · the whole board →