build-images

Build Capsem VM images from TOML configs with Docker or Podman.

68|10|Updated Sep 26, 2025
One-click install
npx skills add https://github.com/google/capsem --skill build-images
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-images
Source: https://github.com/google/capsem/tree/main/skills/build-images
Command: npx skills add https://github.com/google/capsem --skill build-images

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The manual process of building Capsem VM images is complex, error-prone, and slow, involving kernel/rootfs builds, template rendering, and asset packaging across architectures.

Core Features & Use Cases

  • Config-driven builds: reads guest/config TOML, renders Dockerfiles, and outputs per-arch assets under assets/{arch}/.
  • Validation and linting: uses capsem-builder validate to ensure configuration correctness.
  • End-to-end asset generation: builds kernel and rootfs, assembles the final image, and produces a manifest.
  • Quick scaffolding and auditing: supports new image scaffolding and vulnerability audit via capsem-builder audit.

Quick Start

Validate guest configurations and build per-arch assets with capsem-builder.

Frequently Asked Questions about build-images

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate kernel and rootfs builds for VM images across multiple architectures?▼

Automate kernel and rootfs builds using a config-driven workflow that reads TOML configurations, renders Dockerfiles, and compiles per-arch assets via docker or podman. This process outputs architecture-specific image assets and a versioned manifest.

What is the best way to validate guest configurations before compiling a VM image?▼

Validate guest configurations by running the capsem-builder validate command to ensure TOML correctness and lint configuration errors. This prevents misaligned builds before rendering Dockerfile templates and compiling the rootfs.

Can I use docker or podman to build Capsem VM images?▼

Yes, the build process supports both docker and podman to compile the kernel and rootfs and assemble the final image. It enforces a config-driven workflow that renders Dockerfile templates and outputs per-arch assets.

How do I scaffold a new VM image and audit its configuration for vulnerabilities?▼

Scaffold new VM images and audit existing configurations using capsem-builder audit for vulnerability checks. This supports quick scaffolding and ensures configuration correctness before compiling kernel and rootfs assets.

Why does my multi-architecture VM image build fail during template rendering and asset packaging?▼

Multi-architecture VM image builds fail during template rendering when guest TOML configurations are invalid. Running capsem-builder validate enforces configuration correctness and ensures per-arch assets are correctly assembled under the assets path.