gitops-skills

v0.2.0

Skills to transform AI Agents into GitOps Engineers

Codex3 skills1 MCP serverstreamable-http

by The Flux authorsApache-2.0204updated 5 days ago

Source

$ git clone https://github.com/fluxcd/agent-skills

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

gitops-skills/

├── .codex-plugin/plugin.json
├── skills/gitops-cluster-debug/SKILL.md
├── skills/gitops-knowledge/SKILL.md
├── skills/gitops-repo-audit/SKILL.md
└── .mcp.json

Skills3

gitops-cluster-debugskills/gitops-cluster-debug/SKILL.md

Debug and troubleshoot Flux CD on live Kubernetes clusters (not local repo files) via the Flux MCP server — inspects Flux resource status, reads controller logs, traces dependency chains, and performs installation health checks. Use when users report failing, stuck, or not-ready Flux resources on a cluster, reconciliation errors, controller issues, artifact pull failures, image automation not updating tags, alerts or webhooks not being delivered, or need live cluster Flux Operator troubleshooting.

gitops-knowledgeskills/gitops-knowledge/SKILL.md

Flux CD and Flux Operator expert — answers questions and generates schema-validated YAML for all Flux CRDs (not repo auditing or live cluster debugging). Use when users ask about Flux concepts, want manifests for HelmRelease, Kustomization, GitRepository, OCIRepository, ResourceSet, FluxInstance, or any Flux resource. When user needs guidance on GitOps repository structure, bootstrap Flux with Terraform, multi-tenancy, OCI-based delivery, image tag automation, drift detection, preview environments, notifications, or the Flux Web UI and MCP Server.

gitops-repo-auditskills/gitops-repo-audit/SKILL.md

Audit and validate Flux CD GitOps repositories by scanning local repo files (not live clusters) — runs Kubernetes schema validation, detects deprecated Flux APIs, reviews RBAC/multi-tenancy/secrets management, and produces a prioritized GitOps report. Use when users ask to audit, analyze, validate, review, or security-check a GitOps repo.

MCP servers1

flux-schema-catalogstreamable-http

url: https://schemas.fluxoperator.dev/mcp

Manifests1

.codex-plugin/plugin.json

{
  "author": {
    "email": "cncf-flux-dev@lists.cncf.io",
    "name": "The Flux authors",
    "url": "https://github.com/fluxcd"
  },
  "description": "Skills to transform AI Agents into GitOps Engineers",
  "homepage": "https://github.com/fluxcd/agent-skills",
  "interface": {
    "capabilities": [
      "Read",
      "Write"
    ],
    "category": "Development",
    "displayName": "FluxCD GitOps Skills",
    "longDescription": "Collection of reusable AI skills for Flux CD workflows, manifest generation, repository auditing, and cluster debugging.",
    "shortDescription": "Skills to transform AI Agents into GitOps Engineers",
    "websiteURL": "https://fluxcd.io/"
  },
  "license": "Apache-2.0",
  "mcpServers": "./.mcp.json",
  "name": "gitops-skills",
  "repository": "https://github.com/fluxcd/agent-skills",
  "skills": "./skills/",
  "version": "0.2.0"
}