Claude MarketplacesSubmit
fluxcd avatar

Gitops Cluster Debug

fluxcd/agent-skillsOfficial

This is a specialized debugger for live Flux CD clusters that connects via the Flux MCP server to diagnose GitOps pipeline failures. It walks through systematic workflows to troubleshoot HelmReleases, Kustomizations, and ResourceSets by inspecting status conditions, tracing dependencies, reading controller logs, and analyzing the Flux Operator installation. The workflows are opinionated and thorough, pulling API schemas, checking inventory, and following the entire chain from a failed resource back to its source. Use this when reconciliation is stuck or controllers are crashlooping and you need more than kubectl output to understand what's breaking.

skills.sh installs
1.2K
GitHub stars
244
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add fluxcd/agent-skills --skill gitops-cluster-debug --agent claude-code

Installs into .claude/skills of the current project.

Files

Flux Cluster Debugger

You are a Flux cluster debugger specialized in troubleshooting GitOps pipelines on live Kubernetes clusters. You use the flux-operator-mcp MCP tools to connect to clusters, fetch Flux and Kubernetes resources, trace delivery pipelines, analyze status conditions, events and logs, and identify root causes.

MCP Tools

The server exposes read-only tools in every mode and write tools only when it is not started with --read-only. Check which tools you actually have before planning an action.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/fluxcd/agent-skills
Categories
Backend & APIs, DevOps & CI/CD, AI & Agent Building, Debugging, Automation & Workflows, Generative Media
First seen
Jun 3, 2026

More from fluxcd/agent-skills

All 3

Recommended

More Backend & APIs
1vtex avatarvtex-io-service-paths-and-cdnvtex/skillsApply when defining service.json routes, choosing public vs segment vs private URL prefixes for VTEX IO services, or setting HTTP cache headers that interact wi1.2Kskills.sh installs
2antvis avatarantv-s2-expertantvis/chart-visualization-skillsS2 multi-dimensional cross-analysis table development assistant (Expert Skill). MUST act as priority when users mention the following keywords: 交叉表, 透视表, 明细表, 多1.2Kskills.sh installs
3vtex avatarvtex-io-messages-and-i18nvtex/skillsApply when implementing localization and translated copy in VTEX IO apps. Covers the `messages` builder, `/messages/*.json`, `context.json`, frontend message us1.2Kskills.sh installs
4jezweb avatard1-migrationjezweb/claude-skillsCloudflare D1 migration workflow: generate with Drizzle, inspect SQL for gotchas, apply to local and remote, fix stuck migrations, handle partial failures. Use 1.2Kskills.sh installs
5vintasoftware avatardjango-celery-expertvintasoftware/django-ai-pluginsExpert Django Celery guidance for asynchronous task processing. Use when designing background tasks, configuring Celery workers, handling task retries and error1.2Kskills.sh installs
6heygen-com avatarvideo-translateheygen-com/skillsTranslate and dub existing videos into multiple languages using HeyGen. Use when: (1) Translating a video into another language, (2) Dubbing video content with 1.2Kskills.sh installs