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.