Skills
.Work. You
Rest

gitops-cluster-debug

Official

Diagnose Flux on live clusters and fix issues.

Software Engineering#debugging#logs#kubernetes#root-cause#flux#fluxcd#cluster-debugging
Authorfluxcd
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Debug Flux on live Kubernetes clusters by diagnosing installation health, controller readiness, and resource status to surface root causes and guide remediation.

Core Features & Use Cases

  • Workflow-driven cluster debugging: perform Flux installation checks, inspect FluxInstance, FluxReport, and controller deployments; trace issues through Kustomizations, HelmReleases, ResourceSets, and Git repositories; read logs and inventory to build root-cause analyses.
  • Guided remediation: generate actionable steps, commands, and references to fix issues on a live cluster.
  • Real-world scenarios: reproduce troubleshooting patterns for common Flux failures like fetch errors, RBAC, or degraded controllers.

Quick Start

Connect to the target cluster and run the live-cluster debugging workflow to identify Flux issues and generate a remediation plan.

Dependency Matrix

Required Modules

None required

Components

referencesassets

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: gitops-cluster-debug
Download link: https://github.com/fluxcd/agent-skills/archive/main.zip#gitops-cluster-debug

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.