About

Imported from majiayu000/claude-skill-registry (skills/data/vm-bootstrap/SKILL.md). Install upstream with npx skills add majiayu000/claude-skill-registry --skill vm-bootstrap. Copyright stays with the author.

Linux VM Bootstrap Verification

Name: vm-bootstrap
Author: majiayu000

Verify and optionally install required tools for a standardized Linux development VM.

Modes

Mode	Behavior	Use Case
`check`	Warn-only, never modifies	Local DX entrypoint, agents
`install`	Prompt before each install	Interactive bootstrap
`strict`	Exit non-zero on first missing required tool	CI jobs

Required Tools

Tool	Why	Source	Verify
`git`	repo sync, PRs	apt	`git --version`
`curl`	installers, API calls	apt	`curl --version`
`jq`	parse JSON (Railway/GH)	brew (apt fallback)	`jq --version`
`rg` (ripgrep)	fast search	apt or brew	`rg --version`
`tmux`	multi-agent sessions	apt or brew	`tmux -V`
`mise`	toolchain versions	mise installer	`mise --version`
`python`	backend + scripts	mise (per repo)	`mise exec -- python --version`
`poetry`	python deps	pipx or mise	`poetry --version`
`node`	frontend + tooling	mise (per repo)	`mise exec -- node --version`
`pnpm`	monorepo installs	mise / corepack	`mise exec -- pnpm --version`
`gh`	PRs + auth	brew	`gh --version && gh auth status`
`railway`	env/shell/deploy	mise (`@railway/cli`)	`mise exec -- railway --version`
`bd`	Beads tasks	Beads installer	`bd --version`

Optional Tools (warn-only)

Tool	Why	Verify
`bv`	Beads graph insights	`bv --version`
`playwright`	UI/E2E	`mise exec -- playwright --version`
`tailscale`	cross-VM networking	`tailscale status`
`docker`	Railway `railway dev` / local deps	`docker --version`

Security Rules (MUST FOLLOW)

Never print tokens to logs or stdout
Never store secrets in YAML, .env files, or repo
Railway vars are for app runtime only (not runner/gh/tailscale credentials)
gh auth and railway login use interactive prompts or GitHub secrets

Dirty Repo Safety

Before running in install or strict mode:

Check git status --porcelain
If dirty:
- In check mode: warn and continue
- In install/strict mode: refuse and suggest:
  - Commit/stash changes first, OR
  - Use /dirty-repo-bootstrap skill to snapshot to WIP branch

Agent Identity (DX_AGENT_ID)

Recommended: Set DX_AGENT_ID for consistent agent identification across repos and sessions.

# Add to ~/.bashrc, ~/.zshrc, or ~/.profile
export DX_AGENT_ID="$(hostname -s)-claude-code"

Format: <magicdns-host>-<platform> Examples: v2202509262171386004-claude-code, macmini-codex-cli

Why: Provides stable identity for git trailers, Agent Mail coordination, and multi-repo workflows.

Helper script:

~/.agent/skills/scripts/get_agent_identity.sh

Status: P2, warn-only. Missing DX_AGENT_ID triggers warnings but doesn't block operations.

See DX_AGENT_ID.md for full specification and migration path.

Agent Guidance

When this skill is relevant:

Detect OS is Linux (refuse on macOS/Windows with clear message)
Run verification for each required tool
In check mode: report status (✓/✗) for each tool
In install mode: prompt before each install
In strict mode: exit 1 on first missing required tool

Command Usage

# Check mode (default, safe for agents)
./vm-bootstrap/check.sh
# or
./vm-bootstrap/verify.sh check

# Install mode (interactive, operator-confirmed)
./vm-bootstrap/install.sh

# Strict mode (CI)
./vm-bootstrap/verify.sh strict

Note: check.sh is a wrapper for verify.sh check. install.sh provides interactive tool installation following the LINUX_VM_BOOTSTRAP_SPEC phases.

Integration

DX entrypoints should call vm-bootstrap check as first step:

# In scripts/bd-context or make dx-doctor
~/agent-skills/vm-bootstrap/verify.sh check

Related Skills

toolchain-health: Python-specific mise/Poetry alignment
mcp-doctor: MCP server health check
skills-doctor: Skills discovery and loading verification

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/majiayu000-claude-skill-registry-vm-bootstrap/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

majiayu000-claude-skill-registry-vm-bootstrap.ocm.jsonjson

{
  "ocm": "1",
  "id": "majiayu000-claude-skill-registry-vm-bootstrap",
  "kind": "skill",
  "name": "vm-bootstrap",
  "description": "Linux VM bootstrap verification skill. MUST BE USED when setting up new VMs or verifying environment. Supports modes: check (warn-only), install (operator-confirmed), strict (CI-ready). Enforces Linux-only + mise as canonical; honors preference brew→npm (with apt fallback). Verifies required tools: mise, node, pnpm, python, poetry, gh, railway, bd, tmux, jq, rg. Handles optional tools as warnings: tailscale, playwright, docker, bv. Never prints/seeds secrets; never stores tokens in repo/YAML; Railway vars only for app runtime env. Safe on dirty repos (refuses and points to dirty-repo-bootstrap skill, or snapshots WIP branch). Keywords: vm, bootstrap, setup, mise, toolchain, linux, environment, provision, verify, new vm",
  "publisher": "majiayu000",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "dx",
      "tooling",
      "setup",
      "linux",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Linux VM bootstrap verification skill. MUST BE USED when setting up new VMs or verifying environment. Supports modes: check (warn-only), install (operator-confirmed), strict (CI-ready). Enforces Linux-only + mise as canonical; honors preference brew→npm (with apt fallback). Verifies required tools: mise, node, pnpm, python, poetry, gh, railway, bd, tmux, jq, rg. Handles optional tools as warnings: tailscale, playwright, docker, bv. Never prints/seeds secrets; never stores tokens in repo/YAML; Railway vars only for app runtime env. Safe on dirty repos (refuses and points to dirty-repo-bootstrap skill, or snapshots WIP branch). Keywords: vm, bootstrap, setup, mise, toolchain, linux, environment, provision, verify, new vm"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/majiayu000/claude-skill-registry",
      "path": "skills/data/vm-bootstrap/SKILL.md",
      "ref": "a16e8e7bdddc9a7406a56f51e520cef7a8646208",
      "url": "https://github.com/majiayu000/claude-skill-registry/blob/a16e8e7bdddc9a7406a56f51e520cef7a8646208/skills/data/vm-bootstrap/SKILL.md",
      "key": "majiayu000/claude-skill-registry/skills/data/vm-bootstrap/SKILL.md"
    }
  },
  "instructions": "# Linux VM Bootstrap Verification\n\nVerify and optionally install required tools for a standardized Linux development VM.\n\n## Modes\n\n| Mode | Behavior | Use Case |\n|------|----------|----------|\n| `check` | Warn-only, never modifies | Local DX entrypoint, agents |\n| `install` | Prompt before each install | Interactive bootstrap |\n| `strict` | Exit non-zero on first missing required tool | CI jobs |\n\n## Required Tools\n\n| Tool | Why | Source | Verify |\n|------|-----|--------|--------|\n| `git` | repo sync, PRs | apt | `git --version` |\n| `curl` | installers, API calls | apt | `curl --version` |\n| ",
  "cost": {
    "context_tokens": 1027
  }
}

Fetch it by URL: GET /api/v1/registry/majiayu000-claude-skill-registry-vm-bootstrap/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.