homelab-intelligence

Aggregate homelab telemetry into a structured health report with prioritized remediation steps.

44|3|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/vonrobak/fedora-homelab-containers --skill homelab-intelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homelab-intelligence
Source: https://github.com/vonrobak/fedora-homelab-containers/tree/main/.claude/skills/homelab-intelligence
Command: npx skills add https://github.com/vonrobak/fedora-homelab-containers --skill homelab-intelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill gathers comprehensive system intelligence, analyzes health, and provides actionable recommendations for the homelab infrastructure.

Core Features & Use Cases

  • Intelligence Gathering: Executes the homelab intelligence script to collect current system state.
  • Output Analysis & Health Scoring: Reads the JSON report to classify issues as Critical (Priority 1), Warnings (Priority 2), and Info.
  • Proactive Recommendations: Delivers context-aware steps to remediate issues and optimize performance.
  • Pattern Detection: Identifies common patterns (disk space concerns, service outages, resource pressure) to guide maintenance.
  • Documentation & ADR Reference: Links to relevant docs and ADRs for architectural decisions.

Quick Start

Run the intelligence workflow to gather current state:

  • cd ~/containers
  • ./scripts/homelab-intel.sh The script always generates a JSON report at docs/99-reports/intel-<timestamp>.json.

Frequently Asked Questions about homelab-intelligence

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

FAQPage Schema
How do I aggregate homelab telemetry to assess system health?

Run the homelab intelligence script from ~/containers/scripts/homelab-intel.sh to aggregate telemetry across services, disks, backups, SSL validity, monitoring stack, and network connectivity. The script generates a structured JSON health report at docs/99-reports/intel-<timestamp>.json with issues prioritized as Critical, Warnings, or Info, plus actionable remediation steps.

What does homelab health monitoring and diagnostics actually do?

Homelab health monitoring collects current system state, analyzes infrastructure signals, classifies issues by severity, identifies patterns like disk space concerns or service outages, and delivers context-aware recommendations linked to documentation and architectural decisions for troubleshooting.

Can I use automation to detect system health issues before they become critical?

Yes. Pattern detection identifies common infrastructure problems—resource pressure, service outages, backup failures, SSL certificate expiry, and connectivity issues—before they escalate. Proactive recommendations guide preventive maintenance and performance optimization across your homelab.

How do I get actionable next steps from health diagnostics?

The JSON report classifies each finding with priority level, includes remediation steps specific to the issue type, and links to relevant documentation and ADRs. Use this structured output to prioritize maintenance tasks and make informed architectural decisions.

What homelab components does health intelligence cover?

Health intelligence assesses services, disk usage, backup status, SSL certificate validity, monitoring stack health, and network connectivity. It delivers a single, comprehensive view of infrastructure state across all these domains in one structured report.