Agent skill

kubesearch

Search kubesearch.dev to research how other homelabs configure Helm charts. Use when: (1) Configuring a new Helm release, (2) Looking for configuration examples, (3) Comparing approaches across repositories, (4) Needing real-world values.yaml patterns, (5) Researching best practices for specific charts, (6) Finding example implementations. Triggers: "how do others configure", "show me examples", "helm chart examples", "configuration examples", "values.yaml examples", "kubesearch", "homelab examples", "how do other homelabs", "real-world config", "chart configuration", "helm values examples", "compare helm configs", "best practices for helm"

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/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:

markdown
## <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
...

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results