k8s-flux-troubleshooting
Use when Flux does not deploy or update something in Kubernetes: a GitRepository, OCIRepository or HelmRepository that is not Ready ("couldn't find remote ref", "authentication required"), a Kustomization that is not Ready ("kustomization path not found", "kustomize build failed", "dependency ... is not ready", health check timeouts), a HelmRelease that is not Ready (HelmChart "invalid chart reference", InstallFailed, UpgradeFailed, RetriesExceeded), changes in Git that never reach the cluster, or suspended Flux objects. Investigates with kubectl get, describe, events and logs, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision ce7de97330d7, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-flux-troubleshooting/SKILL.md
- skills/k8s-flux-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-flux-troubleshooting/references/helmreleases.md
- skills/k8s-flux-troubleshooting/references/kustomizations.md
- skills/k8s-flux-troubleshooting/references/sources.md
- skills/k8s-flux-troubleshooting/references/suspend-and-controllers.md
Every link opens the file at its source, pinned to the revision this page describes.