create-pi-host

Generate NixOS configurations and user scaffolding for Raspberry Pi hosts in an RPC cluster.

8|1|Updated Oct 21, 2015
One-click install
npx skills add https://github.com/iamruinous/nix-config --skill create-pi-host
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-pi-host
Source: https://github.com/iamruinous/nix-config/tree/main/.opencode/skills/create-pi-host
Command: npx skills add https://github.com/iamruinous/nix-config --skill create-pi-host

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create a new Raspberry Pi host for the RPC (Raspberry Pi Cluster) and generate the necessary NixOS and user-setup scaffolding to bring a new node online quickly.

Core Features & Use Cases

  • Provision host directories and configuration files (configuration.nix, hardware-configuration.nix) for a Raspberry Pi cluster.
  • Auto-create user accounts and initial home configurations, ready for blueprint-based deployment.
  • Integrate with the RPC workflow to add Pi 4 or Pi 5 nodes using NATO phonetic names.

Quick Start

Instantiate a new Raspberry Pi host by specifying the model and NATO name, for example /create-pi-host rpc-5-alpha

Frequently Asked Questions about create-pi-host

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Raspberry Pi cluster provisioning with NixOS?

Automating Raspberry Pi cluster provisioning with NixOS involves generating configuration.nix and hardware-configuration.nix files to define host state. This Skill scaffolds those directories and registers the host in your flake automatically.

How do I add a new Raspberry Pi 5 node to an existing NixOS flake?

Adding a new Raspberry Pi 5 node to a NixOS flake requires creating a host directory and updating the piHosts section. This Skill parses a NATO-name identifier and generates the necessary configuration files for registration.

Can I use this to provision both Raspberry Pi 4 and Pi 5 hosts in the same cluster?

Yes, provisioning both Raspberry Pi 4 and Pi 5 hosts in the same cluster is supported. The Skill parses and validates the Pi model from the hostname input to generate the correct NixOS configuration scaffolding.

What is a NATO phonetic name and why is it needed for Pi host creation?

A NATO phonetic name like 'alpha' serves as a standardized identifier for parsing and validating hostnames during Pi host creation. It ensures consistent naming conventions across multi-host NixOS deployments.

Does this Skill generate user home configurations for NixOS Raspberry Pi nodes?

Yes, it generates user home configurations for NixOS Raspberry Pi nodes. Alongside hardware-configuration.nix, the Skill auto-creates initial user accounts and home-configuration.nix files ready for blueprint-based deployment.