菜单
Inspect an existing or prospective NixOS host before applying tsurf. Use when an agent needs to choose a safe tsurf setup path, adapt to unknown disk/network/provider details, determine whether a host can use the public roles directly, or collect facts for a private overlay.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Create or update a private tsurf overlay from discovered host facts. Use when an agent needs to author NixOS modules, choose public tsurf role modules, or preserve private services.
Validate a tsurf public repo or private overlay before deployment. Use when an agent is about to run checks, prepare a deploy, override a deploy target, verify rollback/recovery safety, or decide whether a tsurf host change is safe enough to push.
Deploy tsurf NixOS config to a server
Run tests and manage .test-status for the tsurf repo
Create a new NixOS module for the tsurf repo
| name | tsurf-host-discovery |
| description | Inspect an existing or prospective NixOS host before applying tsurf. Use when an agent needs to choose a safe tsurf setup path, adapt to unknown disk/network/provider details, determine whether a host can use the public roles directly, or collect facts for a private overlay. |
Use this skill before writing a host config or running a deploy. Treat the
target host and private overlay as the source of truth; do not assume the public
QEMU /dev/sda examples fit the machine.
ssh root@host '. /etc/os-release; hostnamectl --static; uname -m; findmnt --real; ip -brief addr; ip route; lsblk -o NAME,TYPE,SIZE,FSTYPE,MOUNTPOINTS,MODEL,SERIAL'.lsblk evidence./32 provider gateway, systemd-networkd requirement,
Tailscale/headscale dependency, or public SSH bootstrap.inputs.tsurf.nixosModules.* modules when possible; use the
public agent-host role only when the host should run brokered agents. Use
agent-host-with-secrets only after the host has real sops and persisted
SSH host-key wiring.tsurf-overlay-authoring with the discovered facts and any
uncertainty that needs an explicit operator decision.nixos-rebuild switch, disko, partitioning, or deploy commands
from this skill.