helmrelease-debugger

name	helmrelease-debugger
description	Debug Flux HelmRelease install, upgrade, chart, values, and dependency failures.

HelmRelease Debugger

Use this skill when a Flux HelmRelease fails to install, upgrade, or reconcile.

Workflow

1. List HelmReleases with k8s_get_resources using apiVersion=helm.toolkit.fluxcd.io/v2 and kind=HelmRelease.
2. Describe the failing HelmRelease with k8s_describe_resource.
3. Check the referenced HelmRepository or GitRepository source.
4. Check for missing CRDs, chart version errors, bad values, immutable field changes, and resource ownership conflicts.
5. Review namespace events with k8s_get_events.
6. Recommend only Git-backed changes to the HelmRelease, chart values, or source definition.

Output

Return:

• HelmRelease and namespace
• Chart name and version
• Failed condition message
• Probable failure class
• Minimal GitOps change to fix it