Agentic build skills
These skills support you building NumericalOS targets on your own machine. Nothing here generates images and nothing here hosts them.
Point your agent at AGENTS.md for the protocol, or take the whole bundle: skills.zip.
| skill | when it fires |
|---|---|
| numericalos-build-initramfs | Build a NumericalOS initramfs (cpio.gz) whose /init is the graph-driven bootstrap. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS initramfs, initrd, or the userspace half of bootable media. Assembles a static busybox, the boot chain, and a verified numos.state into a cpio archive that a kernel can hand control to. |
| numericalos-build-iso | Build NumericalOS bootable media - a hybrid ISO that boots from optical or USB, pairing a kernel with the graph-driven initramfs. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS ISO, USB stick, bootable image, or bare-metal media. Builds the initramfs first, then wraps kernel plus initramfs in a BIOS/UEFI-bootable image. |
| numericalos-build-oci | Build a NumericalOS OCI container image runnable by Docker, Podman, containerd, or nerdctl. Use when numericalos-target-classifier routed here, or when the user asks for a NumericalOS container/Docker/Podman image. Covers the OCI, rootless-Podman, and LXC/system-container differences honestly rather than flattening them, and states plainly what a container can and cannot prove about a boot. |
| numericalos-target-classifier | Use FIRST, before any NumericalOS build skill, to decide which target the user's machine can actually produce - OCI container image, initramfs, hybrid ISO/USB, or nothing buildable here. Triggers - "build NumericalOS", "make a NumericalOS image", "boot NumericalOS", "which NumericalOS target", "NumericalOS on my machine", or any request to produce NumericalOS bootable media or a container image. Probes the real toolchain rather than assuming, and routes to exactly one build skill. |
| numericalos-verify-boot | Boot a NumericalOS artifact under QEMU and report what actually happened. Use after any NumericalOS build skill, or when the user asks to verify, test, smoke-test, or prove a NumericalOS image boots. This is the ONLY skill in the family permitted to make a boot claim, and only about the exact artifact and architecture it observed. Closes the verification gate the NumericalOS repository itself cannot close. |
The honesty contract
Only numericalos-verify-boot may claim a boot, and only for the
artifact and architecture it observed. Build skills produce artifacts and say
exactly that. This project has never been booted by its authors — if you
build a target, you may be producing its first real boot.