# Flux CD Agent Skills

> A collection of reusable AI agent skills that give AI agents expertise in Flux CD, Kubernetes, and GitOps best practices for generating manifests, auditing repositories, and debugging live clusters.

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.

## Features
- gitops-knowledge skill for answering Flux CD questions and generating YAML manifests
- gitops-repo-audit skill for auditing repository structure, security, and operational readiness
- gitops-cluster-debug skill for troubleshooting live Kubernetes clusters via Flux MCP server
- Bundled OpenAPI schemas for all Flux custom resources
- Cosign-signed OCI artifact distribution
- Support for Claude Code, Codex, and generic .agents/skills convention
- Flux Operator CLI installation with signature verification
- NPX installation via Vercel skills tool
- Manifest validation against OpenAPI schemas
- Deprecated API version detection
- RBAC and multi-tenancy configuration review
- Structured audit reports with prioritized recommendations
- Brewfile for macOS prerequisite installation

## Integrations
Flux CD, Kubernetes, Claude Code, Codex, Flux Operator CLI, flux-operator-mcp, Kustomize, Helm, yq, kubeconform, cosign, GitHub Container Registry (ghcr.io), tessl.io, skills.sh

## Platforms
MACOS, LINUX, WEB, API, DEVELOPER_SDK, CLI

## Pricing
Open Source

## Version
v0.0.3

## Links
- Website: https://fluxcd.io
- Repository: https://github.com/fluxcd/agent-skills
- EveryDev.ai: https://www.everydev.ai/tools/fluxcd-agent-skills