Flux CD Agent Skills

Flux CD Agent Skills is an open-source collection of reusable skills published by the Flux project maintainers under the Apache License 2.0. It is designed to transform AI coding agents into GitOps engineers by providing structured, reference-backed expertise in Flux CD, Kubernetes, and GitOps workflows. The repository was created in February 2026 and reached its v0.0.3 release in April 2026.

What It Is

Agent Skills is a plugin/skill package for AI coding agents such as Claude Code, Codex, and tools supporting the .agents/skills convention. Rather than a standalone application, it is a set of structured skill definitions — bundled with OpenAPI schemas, reference documentation, and prompt guidance — that an AI agent loads at runtime to answer GitOps questions, generate Flux custom resource YAML, audit repository structure, and debug live Kubernetes clusters. The skills are distributed as an OCI artifact signed with cosign and published by the Flux team at ghcr.io/fluxcd/agent-skills.

Available Skills

The repository ships three distinct skills that the agent selects based on context:

• gitops-knowledge — Answers questions about Flux CD and generates up-to-date YAML for all Flux custom resources. Bundled with OpenAPI schemas for every Flux resource and reference documentation covering sources, HelmRelease, Kustomization, ResourceSets, image automation, notifications, repository patterns, and Flux Operator APIs.
• gitops-repo-audit — Audits Flux GitOps repositories for structure, security, and operational best practices. Validates manifests against OpenAPI schemas, detects deprecated API versions, reviews secrets management, source authentication, RBAC and multi-tenancy configuration, and generates a structured report with prioritized recommendations.
• gitops-cluster-debug — Debugs and troubleshoots Flux CD on live Kubernetes clusters using the Flux MCP server. Inspects Flux installation health, diagnoses HelmRelease and Kustomization failures, analyzes pod logs, and traces dependency chains.

Installation Paths

The skills support multiple installation methods to fit different agent environments:

• Flux Operator CLI — Run flux-operator skills install ghcr.io/fluxcd/agent-skills --agent claude-code from the GitOps repository root. The CLI verifies the cosign signature and extracts skills to .agents/skills, with optional per-agent symlinks.
• NPX — npx skills add fluxcd/agent-skills using Vercel's skills tool.
• Claude Code — Via the marketplace: /plugin marketplace add fluxcd/agent-skills then /plugin install gitops-skills@fluxcd.
• Codex — By adding a plugin entry to a marketplace.json file at repo or personal scope.

Prerequisites and Tooling

The skills rely on several CLI tools being present in the agent's environment: flux for dry-running and manifest generation, awk for text processing, yq for YAML parsing and validation, kustomize for building overlays, kubeconform for validating Kubernetes manifests against OpenAPI schemas, and flux-operator-mcp for the cluster debug skill. A Brewfile is provided for easy installation on macOS.

Update: v0.0.3

The latest release is v0.0.3, published on April 19, 2026. The project was created on February 21, 2026, making it a recently launched addition to the Flux ecosystem. The README notes that the maintainers are actively seeking user feedback on accuracy, usefulness, and gaps when steering agents through GitOps tasks, signaling that the project is in an early but actively developed state. The skills are also indexed by third-party registries including tessl.io and skills.sh.