infra-ops

Validate and repair node identity and health for ARM64 K3s clusters.

1|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/villadalmine/infra --skill infra-ops-villadalmine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: infra-ops
Source: https://github.com/villadalmine/infra/tree/main/.agents/skills/infra-ops
Command: npx skills add https://github.com/villadalmine/infra --skill infra-ops-villadalmine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill keeps an ARM64 K3s homelab cluster aligned by checking node identity, health, temperatures, and network settings, then guiding safe RK1 maintenance when devices drift out of sync.

Core Features & Use Cases

  • Verifies hostname, inventory IP, and live IP match across Super6C and RK1 nodes.
  • Runs fast node identity and statistics checks, plus Ansible-based health checks for cluster-wide validation.
  • Diagnoses and fixes RK1-specific issues such as rotating MAC addresses, static IP assignment, and hostname persistence.
  • Supports operational tasks like temperature checks, taint cleanup, and service restarts during incident response.

Quick Start

Ask this skill to audit the cluster, identify any node identity or health mismatches, and recommend the safest recovery steps for the affected RK1 or Super6C node.

Frequently Asked Questions about infra-ops

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

FAQPage Schema
How do I fix a K3s node with a rotating MAC address after a reboot?

To fix a K3s node with a rotating MAC address, enforce persistent MAC settings using systemd-networkd. This Skill validates live network identity against inventory IP and guides safe node-level remediation commands for RK1 agents.

Why does my RK1 agent show hostname drift in my ARM64 homelab?

Hostname drift in an ARM64 homelab occurs when device identity fails to persist after reboots. This Skill diagnoses RK1-specific identity mismatches and recommends safe recovery steps to restore hostname alignment across the cluster.

How do I run an Ansible health check on Super6C CM4 servers?

To run an Ansible health check on Super6C CM4 servers, execute the provided scripts to verify node statistics and inventory IP alignment. The Skill uses Ansible-driven assertions for cluster-wide validation and taint cleanup.

Can I use systemd-networkd to assign static IPs to TuringPi 2 RK1 nodes?

Yes, systemd-networkd can assign static IPs to TuringPi 2 RK1 nodes. This Skill validates and repairs network settings, enforcing static IP assignment to keep K3s nodes healthy and synchronized within the homelab cluster.

What is the best way to troubleshoot K3s node temperatures during an incident?

The best way to troubleshoot K3s node temperatures is to run routine diagnostic checks for operational tasks. This Skill supports temperature checks and service restarts to guide incident response for ARM64 servers.

infra-ops is not repairing node identity mismatches, what are the limitations?

If infra-ops is not repairing node identity mismatches, the limitation may be unresolved reboot-related drift. It requires Ansible-driven assertions and safe node-level remediation commands to successfully validate and repair K3s nodes.