SkVM
The Language Virtual Machine for Agent Skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/sjtu-ipads--skvm)HTML
<a href="/listings/sjtu-ipads--skvm"><img src="/api/listings/sjtu-ipads--skvm/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
# curl one-liner (macOS / Linux) curl -fsSL https://skillvm.ai/install.sh | sh # or via npm (any platform with Node ≥ 18; postinstall fetches the matching binary) npm i -g @ipads-skvm/skvm
The installer drops a standalone binary at `~/.local/share/skvm/bin/skvm` (symlinked into `~/.local/bin/skvm`) and bundles a private, isolated headless agent runtime used internally by `skvm jit-optimize` — it is fully self-contained and does not touch any agent or CLI you may have installed globally.
**Agent-facing skills** ship inside the install. Copy them into your agent harness's skills directory to teach it how to drive skvm:
# OpenClaw cp -r ~/.local/share/skvm/skills/skvm-jit ~/.openclaw/workspace/skills/ cp -r ~/.local/share/skvm/skills/skvm-general ~/.openclaw/workspace/skills/ # Hermes Agent cp -r ~/.local/share/skvm/skills/skvm-jit ~/.hermes/skills/ cp -r ~/.local/share/skvm/skills/skvm-general ~/.hermes/skills/ # pi Agent mkdir -p ~/.pi/agent/skills cp -r ~/.local/share/skvm/skills/skvm-jit ~/.pi/agent/skills/ cp -r ~/.local/share/skvm/skills/skvm-general ~/.pi/agent/skills/
- `skvm-jit` — post-task JIT optimization skill for submitting conversation logs to `skvm jit-optimize` - `skvm-general` — drives `profile` / `aot-compile` / `bench` / `proposals` on behalf of a user
Install SkVM for this machine with the official installer: curl -fsSL https://skillvm.ai/install.sh | sh Then install the two OpenClaw skills with these commands: mkdir -p ~/.openclaw/workspace/skills mkdir -p ~/.openclaw/workspace/skills/skvm-general curl -fsSL https://skillvm.ai/skills/skvm-general/SKILL.md -o ~/.openclaw/workspace/skills/skvm-general/SKILL.md mkdir -p ~/.openclaw/workspace/skills/skvm-jit curl -fsSL https://skillvm.ai/skills/skvm-jit/SKILL.md -o ~/.openclaw/workspace/skills/skvm-jit/SKILL.md curl -fsSL https://skillvm.ai/skills/skvm-jit/adapter-skill-paths.md -o ~/.openclaw/workspace/skills/skvm-jit/adapter-skill-paths.md This should create: ~/.openclaw/workspace/skills/skvm-general/SKILL.md ~/.openclaw/workspace/skills/skvm-jit/SKILL.md ~/.openclaw/workspace/skills/skvm-jit/adapter-skill-paths.md
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 275 lines · 2 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # SkVM
- **Compile and run LLM agent skills across heterogeneous models and harnesses**
- [English](./README.md) | [中文](./README.zh-CN.md)
- [Website](https://skillvm.ai) · [GitHub](https://github.com/SJTU-IPADS/SkVM) · [Paper](https://arxiv.org/abs/2604.03088)
- [](https://www.npmjs.com/package/@ipads-skvm/skvm)
- [](./LICENSE)
- [](https://github.com/SJTU-IPADS/SkVM/releases)
- [](https://github.com/SJTU-IPADS/SkVM/commits)
- </div>
- SkVM is a compilation and runtime system that makes LLM agent skills portable across heterogeneous models and harnesses. It has four major parts:
- - **Profiling** — measure a model+harness against pre-defined primitive capabilities
- - **AOT-Compilation** — compile a skill with multiple passes in AOT compiler
- - **JIT-Optimization** — improve runtime speed (JIT-boost) and skill content (JIT-optimize)
- - **Benchmark** — evaluate original, compiled, and optimized skills across tasks, conditions, and models
- <p align="center">
- <img src="./docs/skvm_arch.png" alt="SkVM architecture" width="66%" />
- </p>
- Reference: **SkVM: Revisiting Language VM for Skills across Heterogenous LLMs and Harnesses** — https://arxiv.org/abs/2604.03088
- ## News
- - **2026-05-18 — Headless pi driver, on by default.** `jit-optimize` and `jit-boost` now run their internal coding agent via [`@mariozechner/pi-coding-agent`](https://www.npmjs.com/package/@mariozechner/pi-coding-agent) in-process by default. Opencode remains a first-class peer — set `headlessAgent.driver: "opencode"` in `skvm.config.json` to keep using it. `ProposalMeta.optimizerDriver` records which driver produced each proposal for replay / audit.
- - **2026-05** — New `claude-code` adapter (drives the `claude -p` CLI). Note: heavy headless usage may hit account rate limits or usage-terms issues.
- - **2026-05** — Upload and optimize a skill with SkVM in your browser: [SkVM website](https://skillvm.ai/index.html#optimize-skill).
- ## Demo
- ### SkVM Optimization: Skill Quality Comparison
- <div align="center">
- <video src="https://github.com/user-attachments/assets/b21132b5-a697-41b9-a802-476389bdb466"/>
- </div>
- ### SkVM Accelerates Agent Execution
- <div align="center">
- <video src="https://github.com/user-attachments/assets/05636f9e-1d13-43c6-b82b-43af577fbf52"/>
- </div>
- ## Install
- ```bash
- # curl one-liner (macOS / Linux)
- curl -fsSL https://skillvm.ai/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 55 on GitHub
- # or via npm (any platform with Node ≥ 18; postinstall fetches the matching binary)
- npm i -g @ipads-skvm/skvm
- ```
- The installer drops a standalone binary at `~/.local/share/skvm/bin/skvm` (symlinked into `~/.local/bin/skvm`) and bundles a private, isolated headless agent runtime used internally by `skvm jit-optimize` — it is fully self-contained and does not touch any agent or CLI you may have installed globally.
- **Agent-facing skills** ship inside the install. Copy them into your agent harness's skills directory to teach it how to drive skvm:
- ```bash
- # OpenClaw
- cp -r ~/.local/share/skvm/skills/skvm-jit ~/.openclaw/workspace/skills/
- cp -r ~/.local/share/skvm/skills/skvm-general ~/.openclaw/workspace/skills/
- # Hermes Agent
- cp -r ~/.local/share/skvm/skills/skvm-jit ~/.hermes/skills/
- cp -r ~/.local/share/skvm/skills/skvm-general ~/.hermes/skills/
- # pi Agent
- mkdir -p ~/.pi/agent/skills
- cp -r ~/.local/share/skvm/skills/skvm-jit ~/.pi/agent/skills/
- cp -r ~/.local/share/skvm/skills/skvm-general ~/.pi/agent/skills/
- ```
- - `skvm-jit` — post-task JIT optimization skill for submitting conversation logs to `skvm jit-optimize`
- - `skvm-general` — drives `profile` / `aot-compile` / `bench` / `proposals` on behalf of a user
- <!-- ### Quick OpenClaw Integration
- If you want OpenClaw to bootstrap SkVM for itself, you can give OpenClaw the following instruction block. It tells OpenClaw to install SkVM with the official installer, download `skvm-general` and `skvm-jit` from their concrete SkillVM URLs, and place them into OpenClaw's global skills directory at `~/.openclaw/workspace/skills/`.
- ```text
- Install SkVM for this machine with the official installer:
- curl -fsSL https://skillvm.ai/install.sh | sh
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 89 on GitHub
- Then install the two OpenClaw skills with these commands:
- mkdir -p ~/.openclaw/workspace/skills
- mkdir -p ~/.openclaw/workspace/skills/skvm-general
- curl -fsSL https://skillvm.ai/skills/skvm-general/SKILL.md -o ~/.openclaw/workspace/skills/skvm-general/SKILL.md
- mkdir -p ~/.openclaw/workspace/skills/skvm-jit
- curl -fsSL https://skillvm.ai/skills/skvm-jit/SKILL.md -o ~/.openclaw/workspace/skills/skvm-jit/SKILL.md
- curl -fsSL https://skillvm.ai/skills/skvm-jit/adapter-skill-paths.md -o ~/.openclaw/workspace/skills/skvm-jit/adapter-skill-paths.md
- This should create:
- ~/.openclaw/workspace/skills/skvm-general/SKILL.md
- ~/.openclaw/workspace/skills/skvm-jit/SKILL.md
- ~/.openclaw/workspace/skills/skvm-jit/adapter-skill-paths.md
- ```
- **After installation, when executing any task that uses a skill, append this instruction to the task: "If this task uses a skill, use SkVM to optimize that skill during or after execution."**
- This is the quickest way to make an OpenClaw environment self-host the SkVM toolchain and the two integration skills without requiring a separate manual setup flow. -->
- ## Quick Start
- Configure your agent harness, provider, and API key via the interactive wizard:
- ```bash
- skvm config init
- ```
- This writes `$SKVM_CACHE/skvm.config.json` (default `~/.skvm/skvm.config.json`). For non-interactive setups, see [docs/providers.md](docs/providers.md).
- **Adapter config mode.** External harnesses run in one of two modes: `managed|native` (default `managed`):
- - **managed** — skvm provisions a fresh, minimal config inside the sandbox (e.g. a new openclaw agent, or a generated `hermes` `config.yaml`). Clean baseline, no reliance on host state.
- - **native** — skvm clones the user's existing harness config (e.g. an openclaw source agent under `~/.openclaw/agents/<name>`, or a hermes active profile). Requires the harness to be set up locally first.
- **Model id format.** Model parameters on the CLI take the form `<provider>/<model-id>` — the leading `<provider>` selects the model service provider, while `<model-id>` is how that provider refers to the model. For OpenRouter that's three segments, e.g. `openrouter/qwen/qwen3.5-35b-a3b`; for the Anthropic native API it's two, e.g. `anthropic/claude-sonnet-4.6`.
- ### 1. Profile a model's primitive capabilities
- Writes a target capability profile to `~/.skvm/profiles/`.
- If your target model + adapter pair is already covered by the pre-built profiles shipped in `skvm-data/profiles/`, you can copy the cached result into your local profile cache and skip `skvm profile` entirely:
- ```bash
- mkdir -p ~/.skvm/profiles
- cp -R skvm-data/profiles/. ~/.skvm/profiles/
- ```
- ```bash
- skvm profile \
- --adapter=bare-agent \
- --model=<provider>/<model-id>
- # e.g. --model=anthropic/claude-sonnet-4.6
- # e.g. --model=openrouter/qwen/qwen3.5-35b-a3b
- ```
- With the default `--concurrency=1`, this example typically takes about 20 minutes for one full run. If you want it to finish faster, increase `--concurrency` to profile more primitives in parallel.
- ### 2. Compile a skill against that profile
- The compiler rewrites the skill to match the target's capabilities. A cached profile for the same `--model` + `--adapter` pair must exist when a selected pass consumes it — only pass 1 (`rewrite-skill`) reads the profile (run `skvm profile` first, or use `skvm pipeline` which profiles automatically). A compile of only pass 2/3 (e.g. `--pass=bind-env` for `env-setup.sh` generation) needs no profile; see the `tcp` column of `--list-passes`.
- ```bash
- skvm aot-compile \
- --skill=path/to/skill-dir \
- --model=<provider>/<model-id> \
- --adapter=bare-agent \
- --pass=1 \
- --compiler-model=<provider>/<model-id>
- ```
- Compiled variants are written under `~/.skvm/proposals/aot-compile/<adapter>/<safeModel>/<skillName>/<passTag>/` by default.
- ### 3. Autotune the skill with synthetic tasks
- The optimizer LLM derives tasks from the skill itself, then loops edit → rerun → score.
- By default, synthetic mode generates 2 training tasks and 1 held-out test task.
- ```bash
- skvm jit-optimize \
- --skill=path/to/skill-dir \
- --task-source=synthetic \
- --task-concurrency=3 \
- --target-adapter=bare-agent \
- --optimizer-model=<provider>/<model-id> \
- --rounds=1 \
- --target-model=<provider>/<model-id>
- ```
- Results are written under `~/.skvm/proposals/jit-optimize/<adapter>/<safeTargetModel>/<skillName>/<timestamp>/` by default.
- ### 4. Optimize from an existing conversation log
- No rerun, just diagnose and edit. Good for post-mortems and for the `skvm-jit` post-task optimization hook.
- ```bash
- skvm jit-optimize \
- --skill=path/to/skill-dir \
- --task-source=log \
- --target-adapter=bare-agent \
- --logs=path/to/session.jsonl \
- --optimizer-model=<provider>/<model-id> \
- --target-model=<provider>/<model-id>
- ```
- ### Review, accept, or reject the proposal
- ```bash
- skvm proposals list # CLI listing
- skvm proposals show <id> # CLI detail view
- skvm proposals accept <id> # CLI accept
- skvm ui # Web review UI
- ```
- ## Configuration
- SkVM keeps all runtime artifacts — cached profiles, proposal trees, bench and compile logs — under a single cache root:
- ```
- ~/.skvm/
- ├── profiles/ # Cached target capability profiles
- ├── log/ # Profile, compile, bench, and runtime logs
- └── proposals/ # AOT-compile, jit-boost, jit-optimize outputs
- ```
- The cache is user-global and shared across every directory you invoke `skvm` from, so profiles cached in one project are reused everywhere. Override the location via:
- - `--skvm-cache=<path>` flag (one-off)
- - `SKVM_CACHE` env var (persistent), e.g. `export SKVM_CACHE=/mnt/fast/skvm`
- Individual subdirectories can also be pointed elsewhere with `SKVM_PROFILES_DIR`, `SKVM_LOGS_DIR`, and `SKVM_PROPOSALS_DIR`.
- ## Dataset: skvm-data
- The benchmark skills, tasks, and pre-built profiles live in a separate Git submodule ([SJTU-IPADS/SkVM-data](https://github.com/SJTU-IPADS/SkVM-data)). Clone it if you plan to run `skvm bench` and want to use the bundled skills/tasks directly:
- ```bash
- git submodule update --init # or: git clone --recurse-submodules
- ```
- This populates the `skvm-data/` directory:
- ```
- skvm-data/
- ├── skills/ # 108 skill directories (each contains a SKILL.md)
- ├── tasks/ # 216 task directories (each contains a task.json)
- └── profiles/ # Pre-built target capability profiles
- ├── bare-agent/
- ├── hermes/
- └── openclaw/
- ```
- `skvm bench` resolves skills and tasks from `skvm-data/` by default. Override the location via:
- - `--skvm-data-dir=<path>` flag (one-off)
- - `SKVM_DATA_DIR` env var (persistent)
- Commands that take an explicit `--skill=<path>` or `--task=<path>` do not need the submodule — they work with any directory on disk.
- `skvm-data/profiles/` already includes pre-built profiles for some model + adapter combinations. If the pair you need is already there, copy `skvm-data/profiles/` into your profile cache directory (default: `~/.skvm/profiles/`, or `SKVM_PROFILES_DIR` if set) and you can skip running `skvm profile` for that target. See the profile list in the profiling section above for the currently bundled combinations.
- ```bash
- mkdir -p ~/.skvm/profiles
- cp -R skvm-data/profiles/. ~/.skvm/profiles/
- ```
- ## Learn more
- - **[docs/usage.md](docs/usage.md)** — full command reference: `profile`, `aot-compile`, `run`, `bench`, `jit-optimize`, `proposals`, and more
- - **[docs/architecture.md](docs/architecture.md)** — subsystem map, data flow, and on-disk layout
- - **[docs/grade-protocols.md](docs/grade-protocols.md)** — grader protocol reference for custom `grade.py` task graders
- - **Paper**: https://arxiv.org/abs/2604.03088
- ## Citation
- If you use SkVM in your research, please cite:
- ```bibtex
- @article{chen2026skvm,
- title={SkVM: Revisiting Language VM for Skills across Heterogenous LLMs and Harnesses},
- author={Chen, Le and Feng, Erhu and Xia, Yubin and Chen, Haibo},
- journal={arXiv preprint arXiv:2604.03088},
- year={2026}
- }
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.