A collection of reusable skills that give AI Agents expertise in Flux CD, Kubernetes, and GitOps best practices for generating manifests, answering Flux questions, auditing repository structure, security, operational readiness, and debugging live cluster installations.
Note
These are the official AI Skills for Flux CD, developed by the Flux project maintainers. We are looking for users to try them out and provide feedback on accuracy, usefulness, and any gaps when steering Agents through GitOps tasks. If you have suggestions for improvements or new skills, please open an issue.
Navigate to your GitOps repository root and run:
flux-operator skills install ghcr.io/fluxcd/agent-skills --agent claude-codeThe operator CLI verifies the cosign signature
(validating that the OCI artifact is published by the Flux team)
and extracts the skills in the repo root at .agents/skills.
The --agent flag creates per-skill symlinks from agent-specific directories to the canonical
location. If your agent supports the conventional .agents/skills path, you can omit the --agent flag.
To update the skills run flux-operator skills update.
Install the skills with Vercel's skills tool:
npx skills add fluxcd/agent-skillsFor Claude Code, add the marketplace and install the skills with:
/plugin marketplace add fluxcd/agent-skills
/plugin install gitops-skills@fluxcdThe skills in this repository rely on the following tools being available in the environment:
fluxfor dry running and manifest generationawkfor text processing and data extractionyqfor YAML parsing and validationkustomizefor building kustomize overlayskubeconformfor validating Kubernetes manifests against OpenAPI schemasflux-operator-mcpfor debugging Flux on live Kubernetes clusters (required bygitops-cluster-debug)
A Brewfile is provided for easy installation of the prerequisites on macOS.
The skills are designed to work together and the agent automatically selects the right one
based on context: gitops-knowledge for answering Flux questions and generating manifests,
gitops-repo-audit for validating and auditing repository contents,
and gitops-cluster-debug for troubleshooting live clusters.
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 the Flux Operator APIs.
To invoke the skill, use the following prompts:
What's the recommended GitOps structure for a multi-cluster fleet?
Generate a HelmRelease for oci://ghcr.io/my-org/frontend,
and a Kustomization to deploy it in the staging cluster.
How do I set up preview environments for pull requests with Flux Operator?
This skill works best in the context of a GitOps repository that contains an AGENTS.md
or CLAUDE.md with details about your organization's structure, cluster topology,
and secret management approach. The agent combines the skill's reference files with
the repository context to generate manifests tailored to your setup.
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.
To invoke the skill, use the following prompt:
Audit the current repo and provide a GitOps report.
In Claude Code, you can also invoke the skill directly with /gitops-repo-audit.
To run only the manifest validation phase, use:
Validate my repo without auditing it.
This prompt can be used when changes have been made to the repository, and you want to re-run the validation checks without performing a full audit.
You can also use the skill to audit only the files with changes:
Run a GitOps audit only on the files with changes.
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.
To invoke the skill, use the following prompts:
Check the Flux installation on my current cluster.
Debug the failing HelmRelease podinfo in the apps namespace.
Troubleshoot the Kustomization flux-system/infra-controllers in the staging cluster.
The flux-operator-mcp server can be configured in Claude Code with:
claude mcp add --scope project --transport stdio flux-operator-mcp \
--env KUBECONFIG=$HOME/.kube/config \
-- flux-operator-mcp serve --read-onlyNote that the --read-only flag will prevent the Agent from making any changes to the cluster.
The MCP server masks Kubernetes Secrets, the Agent receives only the data key names without values.
The Flux skills are indexed by various 3rd-party services: