kubesearch

SKILL.md

KubeSearch - Homelab Helm Configuration Research

Search kubesearch.dev to find real-world Helm configurations from other homelab repositories.

Workflow

1. Search for the Helm Chart

Fetch the search page to find available charts:

WebFetch: https://kubesearch.dev/?search=<chart-name>
Prompt: List all matching helm releases with their full registry paths

2. Get Chart Page with Direct Links

Convert the registry path to URL format (replace / with -):

Registry Path URL Path
ghcr.io/grafana-helm-charts/grafana ghcr.io-grafana-helm-charts-grafana
charts.longhorn.io/longhorn charts.longhorn.io-longhorn

Fetch the chart page:

WebFetch: https://kubesearch.dev/hr/<url-path>
Prompt: List repositories with their DIRECT LINKS to HelmRelease files. Include: repo name, stars, version, and the GitHub URL to the config file.

The page provides direct links to each repository's HelmRelease configuration:

  • https://github.com/angelnu/k8s-gitops/blob/main/apps/longhorn-system/app/helmrelease.yaml
  • https://github.com/blackjid/home-ops/blob/main/kubernetes/apps/.../helmrelease.yaml

3. Fetch Configurations

Use the direct links from Step 2. Convert blob URLs to raw URLs for fetching:

URL Type Format
Blob (view) github.com/<owner>/<repo>/blob/<branch>/<path>
Raw (fetch) raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>

Fetch multiple configs in parallel for comparison:

WebFetch: https://raw.githubusercontent.com/<owner>/<repo>/<branch>/<path>/helmrelease.yaml
Prompt: Extract all helm values configuration. Show the complete values section.

Parallel Repository Research

When comparing multiple implementations, fetch 3-5 repositories in parallel using WebFetch.

Selection criteria:

  • Recent activity (updated within 6 months)
  • Higher star count (indicates community trust)
  • Using similar chart version to target
  • Similar infrastructure goals (bare-metal, GitOps, Talos, etc.)

Common Homelab Repositories

High-quality references frequently appearing on kubesearch:

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

Output Format

When presenting findings, structure as:

## <Chart Name> Configuration Research

### Common Patterns
- Pattern 1: ...
- Pattern 2: ...

### Repository Examples

#### <repo-1> (X stars, vY.Z)
- Key configs: ...
- Notable: ...

#### <repo-2>
...

### Recommended Configuration
Based on findings, suggested values for this homelab:
```yaml
# values.yaml
...
Weekly Installs
25
Repository
ionfury/homelab
GitHub Stars
22
First Seen
Feb 25, 2026
Installed on
opencode25
gemini-cli25
amp25
cline25
github-copilot25
codex25