dev-env SKILL.md skillA

dev-env 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/dev-env@git:20261016.432b170

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

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

Keeps a persistent smolvm machine with its dependencies already installed and re-enters it cheaply across sessions. Use when a project needs an isolated development environment that survives stop and start; when deciding what belongs in a Smolfile's init versus what has to run on every boot; when a package installed in a machine has vanished after a restart; or when exec answers "the container smolvm-<hash> is not running". Do not use it for untrusted code, which needs a machine that leaves…

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

# A persistent dev machine

Verified on **smolvm v1.29.0** on macOS arm64, 2026-10-15, and on **v1.18.2** on Linux aarch64, 2026-09-24; the Linux runs used
the Smolfile with `memory = 1024`, for the host reason in "Platform arms". Done means a second `start` is fast, skips provisioning, and the packages installed in
the first session are still there.
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.

The whole use case turns on one fact: **`init` runs once, not on every start**, as
[`smolfile.md`](../smolfile.md) says, and as the docs site (smolmachines.com/docs) says under "When
init runs". `smolvm machine create --help` reads "Run command on every VM start" at v1.22.2, and
"Run command once, on the machine's first start" from v1.23.7; provisioning that relies on the old
line is missing on the second boot.

## Procedure

**1. Preflight.**

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

Read-only. `restart_after_stop=verified` on macOS and Linux. The script covers macOS and Linux
only; elsewhere it prints `unknown` and a note pointing at `references/windows.md`, where a stopped
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add smol-machines/smolvm/dev-env@sha256:8d77f98f764e6133

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_iel2fm6yswnqmmwf.svg)](https://markdownregistry.com/a/art_iel2fm6yswnqmmwf)

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 12,629 BA view · diff
git:20261014.8cf06012026-10-14 8cf0601 12,089 BA view · diff
git:20261006.48084f22026-10-06 48084f2 11,991 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12629 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 curl or wget piped into a shell
  • 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

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_iel2fm6yswnqmmwf
GET https://markdownregistry.com/api/v1/resolve?ref=smol-machines/smolvm/dev-env
GET https://markdownregistry.com/api/v1/blob/8d77f98f764e6133a5d7d945a33f792e1a0c67e11a5bef60a2ce8f153fe8b6dd

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
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
install SKILL.md skill
smol-machines/smolvm · docs/install/SKILL.md · Installs smolvm from a published release and proves the host can actually boot a microVM before any other work starts…
git:20261016.432b170 · audit B · 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

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