About kubesearch
kubesearch is a research skill for finding real Helm configurations in homelab repositories through kubesearch.dev. It helps Kubernetes homelab operators compare relevant releases and inspect linked GitHub HelmRelease files using recency, stars, chart versions, and infrastructure goals as selection criteria.
Key features
- 01Search Helm chart releases
- 02Find repositories linked to releases
- 03Fetch raw HelmRelease configurations
- 04Filter examples by recency and stars
- 05Compare chart versions and infrastructure goals
Use cases
- 01Research a Helm chart before configuring it
- 02Find homelab examples for Flux or Talos
- 03Compare configurations from related repositories
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ ionfury/ homelab --skill kubesearchAfter installing, type/kubesearchin Claude Code to confirm it loaded.
Bundled filesreferences/output-format.mdtests.yaml
Details
From the project READMEKubeSearch - Homelab Helm Configuration Research
Search kubesearch.dev to find real-world Helm configurations from other homelab repositories.
Workflow
Step 1 — Find chart: WebFetch https://kubesearch.dev/?search=<chart-name> → list matching releases with registry paths.
Step 2 — Get repository links: Convert registry path to URL format (replace / with -), then WebFetch https://kubesearch.dev/hr/<url-path> → list repositories with direct GitHub links to HelmRelease files.
Examples of the URL conversion:
ghcr.io/grafana-helm-charts/grafana→ghcr.io-grafana-helm-charts-grafanacharts.longhorn.io/longhorn→charts.longhorn.io-longhorn
Step 3 — Fetch configs: Convert GitHub blob URLs to raw URLs, then fetch 3-5 in parallel:
- Blob:
github.com/<owner>/<repo>/blob/<branch>/<path> - Raw:
raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>
Selection criteria: recent activity (within 6 months), higher star count, similar chart version, similar infrastructure goals (bare-metal, GitOps, Talos).
Common Homelab Repositories
| Repository | Focus |
|---|---|
onedr0p/home-ops | Flux GitOps, extensive automation |
bjw-s/home-ops | App-template patterns |
buroa/k8s-gitops | Talos + Flux |
mirceanton/home-ops | Well-documented configs |
See references/output-format.md for the standard output structure when presenting findings.