distros/skills/arch-builder/SKILL.md
Arch Linux builder image with pixi, Node.js, build toolchain, and yay AUR helper. Default builder for pixi, npm, cargo, and aur multi-stage builds on Arch. MUST be invoked before building, deploying, configuring, or troubleshooting the arch-builder box.
npx skillsauth add overthinkos/overthink-plugins arch-builderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Builder image for Arch Linux multi-stage builds. Counterpart to /charly-distros:fedora-builder — provides the same build capabilities (pixi, npm, cargo) plus AUR support via yay.
| Property | Value | |----------|-------| | Base | arch | | Layers | pixi, nodejs, build-toolchain, yay | | Builds | pixi, npm, cargo, aur | | Platforms | linux/amd64 | | Registry | ghcr.io/overthinkos |
When an Arch-based box has candies with pixi.toml, package.json, Cargo.toml, or aur: packages, the build system uses this image as the builder for multi-stage builds. Configured via the arch box's builder: field (a map of build-type → builder-image):
# charly.yml
arch:
builder:
pixi: arch-builder
npm: arch-builder
cargo: arch-builder
aur: arch-builder
The builder definitions themselves (pixi/npm/cargo/aur) live in build.yml's builder: section — the same word is used intentionally because both maps key on the same slot (the build-type name).
charly box build arch-builder
charly shell arch-builder -c "pixi --version"
charly shell arch-builder -c "node --version"
charly shell arch-builder -c "yay --version"
/charly-distros:arch — parent base image/charly-distros:fedora-builder — Fedora counterpart (same role, no AUR)/charly-tools:yay — AUR helper candy (unique to Arch)/charly-languages:pixi — pixi package manager candy/charly-coder:nodejs — Node.js candy/charly-coder:build-toolchain — C/C++ build tools candycharly shell arch-builder -c "pixi --version && node --version && yay --version && gcc --version"
MUST be invoked when the task involves the arch-builder box, Arch multi-stage builds, or AUR package building infrastructure. Invoke this skill BEFORE reading source code or launching Explore agents.
/charly-image:image — box family umbrella (box: entries in charly.yml, build/validate/inspect/list)/charly-build:build — build.yml vocabulary (distros, builders, init-systems)tools
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
development
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
tools
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
tools
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.