homelab
Operate and deploy the homelab managed by this repo. Use when changing or validating NixOS hosts, k3s cluster nodes, declarative microVMs, remote deploys, kubeconfig-backed cluster operations, or host
SKILL.mdagents/defs/skills/homelab/SKILL.md
GitHubHomelab
Use this skill for homelab work that spans host config, k3s, and microVMs.
Workflow
- Identify the target surface before changing anything:
nixos-ry4afor the microVM hypervisor and assistant VMsnixos-ry6afor the primary k3s servernixos-ry6bfor the secondary k3s agent config- cluster-level Kubernetes resources via local kubeconfig tooling
- Prefer declarative repo changes over imperative host edits.
- Validate locally before any deploy.
- Deploy only the affected host(s), then run the smallest useful verification on-host or in-cluster.
- If a task is microVM-specific, load the microVM reference instead of rediscovering host layout and commands.
Read These References As Needed
references/topology.md: host roles, source-of-truth files, and current caveatsreferences/deploy-and-verify.md: validation, deploy, and verification commandsreferences/microvms.md:nixos-ry4amicroVM layout, assistant VMs, and checks
Working Rules
- Treat Nix files in this repo as the source of truth; avoid hand-editing remote hosts except for inspection or emergency recovery.
- Prefer
nix flake check --no-buildand targetednix build/nix evalbefore remote activation. - For cluster tasks, verify whether the change belongs in host Nix config or in Kubernetes resources before acting.
- Mention blast radius explicitly when a change affects the hypervisor, cluster bootstrap, secrets, ingress, or multiple hosts.
- Assume
nixos-ry6bconfig is real but operationally degraded until the hardware is back in service.