coding-agent SKILL.md skillA

coding-agent 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/coding-agent@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/coding-agent/SKILL.md
Versions recorded
2
Latest version
git:20261016.432b170, committed Oct 16, 2026
First version recorded
Oct 14, 2026
Size
2,616 bytes
Repository stars
6,776
License
Apache-2.0

Runs a coding agent (Claude Code, OpenCode, Codex or any other) inside a persistent smolvm machine with the project mounted, so it can run with full permissions without touching the host. Use when someone wants to sandbox their coding agent, run it in skip-permissions or YOLO mode safely, or give it a disposable environment it can install anything into. Do not use it to run untrusted code with no network; use throwaway-machine for that.

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 coding agent in a machine

Verified on **smolvm v1.27.4** on Linux x86_64, 2026-10-14, and on **v1.29.0** on macOS arm64,
2026-10-15. Done means the agent runs inside the
machine from the project directory, its edits appear on the host, and git works on the mounted
repo.

## Procedure

**1. Copy the Smolfile into the project.** Edit the `npm install` line in `init` to the agents you
use; any install command works.

```bash
cp docs/coding-agent/assets/agent.smolfile ./Smolfile
```

**2. Create and start the machine.** Pass API keys as references so they are read from your host
at launch, never written to the machine record:

```bash
smolvm machine create --name agent -s Smolfile --secret-env ANTHROPIC_API_KEY=ANTHROPIC_API_KEY
smolvm machine start --name agent      # first start runs init: under a minute once the image is pulled
```

The Smolfile forwards your SSH agent, so `start` needs `SSH_AUTH_SOCK` set on the host: without it,
it stops with `ssh-agent: SSH_AUTH_SOCK is not set`. Start one with `eval $(ssh-agent)`, or delete
the `[auth]` block.

**3. Run the agent.**

```bash
smolvm machine exec --name agent -it -- claude --dangerously-skip-permissions
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add smol-machines/smolvm/coding-agent@sha256:a2fe11bcbba3d250

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

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

Versions

The registry has recorded 2 versions of this file, between Oct 14, 2026 and Oct 16, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261016.432b170 latest2026-10-16 432b170 2,616 BA view · diff
git:20261014.2a17f5a2026-10-14 2a17f5a 2,385 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 (2616 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_psyrmuibcloh5i6y
GET https://markdownregistry.com/api/v1/resolve?ref=smol-machines/smolvm/coding-agent
GET https://markdownregistry.com/api/v1/blob/a2fe11bcbba3d2504f7aafb3303d89d997e79e726b6dfd2383e9ac356c1e16fa

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
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
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

Other files named coding-agent

coding-agent SKILL.md skill
bitterbot-ai/bitterbot-desktop · skills/coding-agent/SKILL.md · Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.
git:20260413.388cdc8 · audit A · 2,476 stars
coding-agent SKILL.md skill
trpc-group/trpc-agent-go · openclaw/skills/coding-agent/SKILL.md · Delegate coding tasks to Codex, Claude Code, or Pi agents via background host sessions. Use when: (1) building or…
git:20260528.9308b28 · audit A · 1,874 stars
coding-agent SKILL.md skill
cowork-os/cowork-os · resources/skills/coding-agent/SKILL.md · Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.
v1.0.0 · audit A · 496 stars
coding-agent SKILL.md skill
evovexai/evoflow · skills/public/coding-agent/SKILL.md · 通过后台进程将编码任务委托给本机已安装的外部编码 Agent CLI(如 Claude Code、OpenCode、Pi)。用于构建功能、审查 PR、大型重构或需要探索式迭代的编码。简单一行修复请直接编辑;读代码请用 read…
git:20260912.6c490fd · audit A · 484 stars
coding-agent SKILL.md skill
metaspartan/cybara · skills/coding-agent/SKILL.md · Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.
git:20260218.a87179d · audit A · 32 stars

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