SkillBench

Standalone skill test runner for AI agent skills. SkillBench runs *.skillbench.{ts,js,mts,mjs} suites in isolated workspaces and writes deterministic reports.

30-second demo

npx @swarmclawai/skillbench@latest init --write
npx @swarmclawai/skillbench@latest run
npx @swarmclawai/skillbench@latest report

Test File

import { defineSkillSuite, fileContains, exitCode } from "@swarmclawai/skillbench";

export default defineSkillSuite({
  name: "demo-skill",
  cases: [
    {
      name: "writes a note",
      workspace: { "input.txt": "hello\n" },
      command: ["node", "agent.mjs"],
      assertions: [exitCode(0), fileContains("note.md", "hello")]
    }
  ]
});

Commands

| Command | Purpose | |---|---| | skillbench init | Print or write a sample suite | | skillbench list [path] | List discovered suites and cases | | skillbench run [path] | Run suites and write .skillbench/latest.json | | skillbench report [path] | Render a Markdown report | | skillbench help-agents | Print the machine-readable command catalog |

Every data-returning command supports --json.