survey

Collect hardware and software facts from heterogeneous Linux cluster nodes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork from cluster planning by collecting consistent hardware, software, networking, and readiness facts from every node before deployment.

Core Features & Use Cases

  • Comprehensive node profiling: Captures CPU, RAM, storage, GPU or NPU, network, DNS, NTP, security posture, and Kubernetes readiness signals.
  • Actionable planning output: Produces both human-readable summaries and per-node JSON files so you can compare machines, spot risks, and assign roles confidently.
  • Preflight validation: Flags issues like swap enabled, cgroups v1, port conflicts, slow storage, or unsynced clocks before they break a K3s bootstrap.

Quick Start

Run the survey skill to collect facts from every inventory node and save a JSON report for each host.

Frequently Asked Questions about survey

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

FAQPage Schema
How do I check hardware readiness before deploying a K3s cluster?

To check K3s cluster readiness, collect node facts covering CPU, RAM, storage, and network posture. This process validates configuration issues like enabled swap or cgroups v1 before they break bootstrap deployment.

What is cluster node profiling for heterogeneous Linux environments?

Cluster node profiling is gathering hardware, software, network, and security facts from diverse Linux machines. It produces per-node JSON exports and human-readable summaries to compare resources and assign cluster roles.

Can I use this node survey for ARM64 homelab environments?

Yes, you can use this node survey for ARM64 homelab environments. It applies to heterogeneous Linux nodes, capturing NTP, DNS, port conflicts, and slow storage warnings for K3s preflight validation.

What K3s preflight checks are needed for slow storage and port conflicts?

K3s preflight checks for slow storage and port conflicts require scanning node facts for blocked Kubernetes ports and evaluating disk speed. This validation generates warnings to resolve readiness issues before deployment.

How do I export JSON hardware facts from multiple Linux nodes?

To export JSON hardware facts from multiple Linux nodes, run a deterministic inventory survey using fallback command paths. This generates a structured JSON file per host alongside a human-readable summary for comparison.