hops

Build and evolve an LLM-optimized Kubernetes cluster operations CLI.

12|Updated Jun 22, 2025
One-click install
npx skills add https://github.com/rcdailey/home-ops --skill hops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hops
Source: https://github.com/rcdailey/home-ops/tree/main/.opencode/skills/hops
Command: npx skills add https://github.com/rcdailey/home-ops --skill hops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The hops skill helps you avoid multi-step, copy-paste troubleshooting across kubectl/talosctl/Flux/Ceph by turning cluster introspection workflows into compact, correlation-rich CLI outputs optimized for LLM context windows.

Core Features & Use Cases

  • LLM-optimized investigative CLI: Produces compact, pre-filtered domain-oriented output (nodes, storage, apps, Flux, DNS, backups, validation, and debug) suitable for fast diagnosis.
  • Unified and flexible target resolution: Resolves targets via a consistent resolver pipeline (workload, gateway, pod) with an explainer mode to reduce dead ends.
  • Stewardship-focused development guidance: Enforces module boundaries, anti-passthrough discipline, output standards, safety constraints (read-only by design), SQL escaping rules, and a testing/testing-first workflow.

Quick Start

Add or modify a hops command by updating the appropriate domain module under scripts/hops/ and describing its investigative workflow in the implementation so it returns correlated context rather than a thin wrapper around a single upstream CLI call.

Frequently Asked Questions about hops

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

FAQPage Schema
How do I troubleshoot Kubernetes cluster issues without copy-pasting commands between kubectl, Flux, and Ceph?

You can troubleshoot Kubernetes cluster issues by using an LLM-optimized CLI that consolidates kubectl, Flux, and Ceph introspection workflows into compact, correlation-rich outputs. This avoids multi-step, copy-paste troubleshooting by returning pre-filtered, domain-oriented context suitable for fast diagnosis.

What is the best way to format kubectl and talosctl outputs for LLM context windows during debugging?

The best way to format kubectl and talosctl outputs for LLM context windows is to use standardized output formatters that produce compact, pre-filtered domain-oriented data. These formatters ensure the CLI returns correlated context across nodes, storage, and apps rather than thin wrapper outputs.

Does this Kubernetes investigation CLI support write operations or is it read-only?

This Kubernetes investigation CLI is read-only by design, enforcing strict safety constraints to prevent accidental modifications. It focuses entirely on cluster introspection and troubleshooting across tools like kubectl, talosctl, and Flux without executing mutating operations.

How do I resolve workloads, gateways, and pods consistently when debugging Flux or Ceph storage problems?

You resolve workloads, gateways, and pods consistently by passing targets through a unified resolver pipeline. This pipeline applies standardized resolver behavior across all domain modules and includes an explainer mode to reduce dead ends during Flux or Ceph storage debugging.

Can I use this CLI to investigate DNS issues and validate backup configurations in a Kubernetes cluster?

Yes, you can investigate DNS issues and validate backup configurations because the CLI includes dedicated domain modules for DNS and backup coverage. The DNS module applies SQL escaping discipline for psql queries, while the validation module ensures configurations are checked during debugging workflows.