# GitOps Agent Skills

[](https://github.com/fluxcd/agent-skills/releases) [](https://github.com/fluxcd/agent-skills/blob/main/LICENSE)

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](https://github.com/fluxcd/agent-skills/issues/new).

## Install

### Using Flux CLI

Install the operator plugin with:

```shell flux plugin install operator ```

Navigate to your GitOps repository root and run:

```shell flux operator skills install ghcr.io/fluxcd/agent-skills --agent claude-code ```

The [Flux Operator](https://fluxoperator.dev/) 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`.

### Using NPX

Install the skills with Vercel's skills tool:

```shell npx skills add fluxcd/agent-skills ```

### Using Claude Code

For Claude Code, add the marketplace and install the skills with:

```shell /plugin marketplace add fluxcd/agent-skills /plugin install gitops-skills@fluxcd ```

### Using Codex

Add the FluxCD marketplace and