cluster-conventions

Review NixOS cluster configurations against defined deployment conventions.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/reverb256/hermes-skills --skill cluster-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cluster-conventions
Source: https://github.com/reverb256/hermes-skills/tree/main/cluster-conventions
Command: npx skills add https://github.com/reverb256/hermes-skills --skill cluster-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures consistency in NixOS cluster configurations and deployment patterns, reducing errors and improving operational efficiency.

Core Features & Use Cases

  • Consistent Configuration: Provides a single source of truth for NixOS module, Kubernetes manifest, Caddy routes, and systemd service patterns.
  • Deployment Patterns: Offers guidelines for scratch image deployments, mkOptionDefault safety, GPU scheduling, and Caddy auth routing.
  • Use Case: Before modifying any .nix file in /etc/nixos/, use this Skill to review the conventions and ensure compliance with best practices.

Quick Start

Run the 'cluster-conventions' skill to review the conventions before editing any configuration files.

Frequently Asked Questions about cluster-conventions

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

FAQPage Schema
How do I ensure consistent NixOS cluster configurations across deployments?

To ensure consistent NixOS cluster configurations, apply standardized deployment patterns for scratch images, mkOptionDefault safety, GPU scheduling, and Caddy auth routing. This provides a single source of truth for NixOS modules, Kubernetes manifests, and systemd services, reducing configuration errors.

What is the best way to handle Caddy auth routing in a NixOS cluster?

The best way to handle Caddy auth routing in a NixOS cluster is to follow predefined configuration conventions. These guidelines ensure your Caddy routes integrate safely with systemd services and Kubernetes manifests, maintaining operational efficiency and consistent deployment patterns.

How do I configure GPU scheduling for Kubernetes manifests on NixOS?

To configure GPU scheduling for Kubernetes manifests on NixOS, review the cluster's deployment conventions. The guidelines provide specific patterns for allocating GPU resources safely within your NixOS modules and Kubernetes manifests to ensure operational consistency.

When do I need to check NixOS module conventions before editing configuration files?

You need to check NixOS module conventions before modifying any .nix file in the /etc/nixos/ directory. Reviewing these deployment patterns ensures your changes comply with scratch image deployments and mkOptionDefault safety guidelines before applying configurations.

Does mkOptionDefault safety prevent configuration overrides in NixOS modules?

Yes, mkOptionDefault safety prevents unintended configuration overrides in NixOS modules. By following this specific deployment pattern, you ensure lower-priority options do not accidentally overwrite explicit user definitions, maintaining cluster configuration consistency and reducing errors.