hops

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.