install SKILL.md skillB

install from smol-machines/smolvm is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add smol-machines/smolvm/install@git:20261016.432b170

Pins git:20261016.432b170 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
smol-machines/smolvm
Path
docs/install/SKILL.md
Versions recorded
3
Latest version
git:20261016.432b170, committed Oct 16, 2026
First version recorded
Oct 6, 2026
Size
14,060 bytes
Repository stars
6,776
License
Apache-2.0

Installs smolvm from a published release and proves the host can actually boot a microVM before any other work starts. Use when setting smolvm up on a new machine, a CI runner or an agent's own environment; when a first boot fails with krun_start_enter -22, KVM_DENIED or "agent did not become ready"; when checking whether a host meets smolvm's requirements at all; or when an install has to be isolated from an existing one and then removed. Do not use it to remove an existing install…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Installing smolvm and proving it works

Verified on **smolvm v1.29.0** on macOS arm64, 2026-10-15, and on **v1.18.2** on Linux aarch64, 2026-09-24. Done means `smolvm --version` prints the release version **and** a throwaway VM has run
one command and exited. A version number alone proves nothing: on every
platform here there is at least one way for the install to succeed and every VM start to fail.
The Linux runs used the scripts of their date; this version's preflight and cleanup scripts ran
on Linux aarch64 on v1.22.2 on 2026-10-03.

`scripts/preflight.sh` reports the host as `key=value` lines and ends with `result=ready`,
`result=not_installed` or `result=blocked`. Run it first, and run it again after the install if
the first boot fails.

## Procedure

**1. Preflight.** Read-only. It starts no VM and writes no smolvm state.

```bash
scripts/preflight.sh
```

`result=not_installed` on a fresh host means the host is fit and smolvm is simply missing: go on
to step 2 and run this again afterwards. With another smolvm first on `PATH`, it describes that one
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add smol-machines/smolvm/install@sha256:c596d7f8b7fb920d

The line at the top of this page pins the label git:20261016.432b170, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ecelohuyrxn3z4x5.svg)](https://markdownregistry.com/a/art_ecelohuyrxn3z4x5)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Oct 6, 2026 and Oct 16, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261016.432b170 latest2026-10-16 432b170 14,060 BB view · diff
git:20261014.8cf06012026-10-14 8cf0601 13,322 BB view · diff
git:20261006.13b5dc72026-10-06 13b5dc7 12,969 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No curl or wget piped into a shell (matched: curl -sSL https://smolmachines.com/install.sh | bash)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14060 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

smol-machines/smolvm · 6,776 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ecelohuyrxn3z4x5
GET https://markdownregistry.com/api/v1/resolve?ref=smol-machines/smolvm/install
GET https://markdownregistry.com/api/v1/blob/c596d7f8b7fb920d8f32de9d5679bc326faf1ee19e03f5655c20142a785984f6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from smol-machines/smolvm

AGENTS.md AGENTS.md file
smol-machines/smolvm · AGENTS.md
git:20261019.f6fd298 · audit A · 6,776 stars
branch-and-checkpoint SKILL.md skill
smol-machines/smolvm · docs/branch-and-checkpoint/SKILL.md · Saves a running smolvm machine as checkpoints on a schedule, keeps a bounded history, restores any generation in it…
git:20261016.432b170 · audit A · 6,776 stars
coding-agent SKILL.md skill
smol-machines/smolvm · docs/coding-agent/SKILL.md · Runs a coding agent (Claude Code, OpenCode, Codex or any other) inside a persistent smolvm machine with the project…
git:20261016.432b170 · audit A · 6,776 stars
credentials SKILL.md skill
smol-machines/smolvm · docs/credentials/SKILL.md · Gives a workload in a smolvm machine an API key or token it can use but never read, by binding the credential to named…
git:20261016.432b170 · audit A · 6,776 stars
dev-env SKILL.md skill
smol-machines/smolvm · docs/dev-env/SKILL.md · Keeps a persistent smolvm machine with its dependencies already installed and re-enters it cheaply across sessions. Use…
git:20261016.432b170 · audit A · 6,776 stars
docker-in-machine SKILL.md skill
smol-machines/smolvm · docs/docker-in-machine/SKILL.md · Runs a Docker daemon inside a smolvm machine and shows it working there, which is what tools that call Docker…
git:20261016.432b170 · audit A · 6,776 stars
gpu-cuda SKILL.md skill
smol-machines/smolvm · docs/gpu-cuda/SKILL.md · Runs CUDA compute workloads inside a smolvm microVM against a real host NVIDIA GPU, using smolvm's --cuda API remoting…
git:20261016.432b170 · audit A · 6,776 stars
llms.txt@docs llms.txt file
smol-machines/smolvm · docs/llms.txt
git:20261019.bd3e05c · audit A · 6,776 stars
local-api SKILL.md skill
smol-machines/smolvm · docs/local-api/SKILL.md · Drives smolvm programmatically over its local HTTP API (smolvm serve) instead of the CLI: create machines, exec and…
git:20261016.432b170 · audit B · 6,776 stars
pack SKILL.md skill
smol-machines/smolvm · docs/pack/SKILL.md · Turns an image, or a machine already provisioned, into a single self-contained artifact that runs on another compatible…
git:20261016.432b170 · audit A · 6,776 stars
teardown SKILL.md skill
smol-machines/smolvm · docs/teardown/SKILL.md · Stops every smolvm machine a session started, removes smolvm's state, and proves the host is clean. Use after any…
git:20261016.432b170 · audit B · 6,776 stars
throwaway-machine SKILL.md skill
smol-machines/smolvm · docs/throwaway-machine/SKILL.md · Runs untrusted code in a throwaway smolvm microVM against a repo it must not modify, with no network unless explicitly…
git:20261016.432b170 · audit A · 6,776 stars

Every file in smol-machines/smolvm

Other files named install

install SKILL.md skill
jmagly/aiwg · agentic/code/addons/aiwg-utils/skills/install/SKILL.md · Install AIWG-compatible packages from remote Git repositories into the current workspace
git:20260430.6d8a12e · audit A · 225 stars
install SKILL.md skill
tykimos/agent-native-agent · skills/install/SKILL.md · Install and run ANA (Agent-Native Agent) from scratch on macOS, Linux, or Windows (via WSL) — analyze the environment…
git:20261004.6fc35a3 · audit B · 128 stars
install SKILL.md skill
rossoctl/context-guru · context-guru-plugin/skills/install/SKILL.md · Install a local context-guru proxy and route this project's Claude Code sessions through it, so long sessions stop…
git:20260929.ca78058 · audit B · 70 stars
install SKILL.md skill
pierry/harness-kit · skills/install/SKILL.md · Install the harness-kit pipeline into the current project. Copies agents, slash commands, skills, and hooks into the…
git:20261005.0119af1 · audit A · 4 stars
install SKILL.md skill
terrylica/cc-skills · plugins/kokoro-tts/skills/install/SKILL.md · Install Kokoro TTS engine on Apple Silicon. TRIGGERS - install kokoro, setup tts, kokoro install, tts setup.
git:20260807.b89e550 · audit A · 0 stars
install SKILL.md skill
terrylica/cc-skills · plugins/openwolf/skills/install/SKILL.md · Install openwolf npm and run `openwolf init` in cwd. TRIGGERS - install openwolf, openwolf init, set up openwolf.
git:20260506.2975247 · audit A · 0 stars
install SKILL.md skill
terrylica/cc-skills · plugins/floating-clock/skills/install/SKILL.md · Build FloatingClock from source and install to /Applications, then launch. Use when user wants to install the…
git:20260807.b89e550 · audit A · 0 stars

Browse by kind, by grade B, or by owner.