{"id":47873671,"url":"https://github.com/fluxcd/agent-skills","last_synced_at":"2026-04-22T05:35:07.236Z","repository":{"id":339832706,"uuid":"1163373343","full_name":"fluxcd/agent-skills","owner":"fluxcd","description":"Skills to transform AI Agents into GitOps Engineers","archived":false,"fork":false,"pushed_at":"2026-03-15T19:12:57.000Z","size":261,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-16T07:30:53.642Z","etag":null,"topics":["agent-skills","ai-agents","fluxcd","gitops","skills"],"latest_commit_sha":null,"homepage":"https://fluxcd.io","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fluxcd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-21T14:34:00.000Z","updated_at":"2026-03-15T19:13:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fluxcd/agent-skills","commit_stats":null,"previous_names":["fluxcd/skills","fluxcd/agent-skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fluxcd/agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluxcd%2Fagent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluxcd%2Fagent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluxcd%2Fagent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluxcd%2Fagent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fluxcd","download_url":"https://codeload.github.com/fluxcd/agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fluxcd%2Fagent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31997804,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","fluxcd","gitops","skills"],"created_at":"2026-04-04T01:00:45.786Z","updated_at":"2026-04-22T05:35:07.230Z","avatar_url":"https://github.com/fluxcd.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# GitOps Agent Skills\n\n[![release](https://img.shields.io/github/release/fluxcd/agent-skills/all.svg)](https://github.com/fluxcd/agent-skills/releases)\n[![license](https://img.shields.io/github/license/fluxcd/agent-skills.svg)](https://github.com/fluxcd/agent-skills/blob/main/LICENSE)\n\nA collection of reusable skills that give AI Agents expertise in Flux CD,\nKubernetes, and GitOps best practices for generating manifests, answering Flux questions,\nauditing repository structure, security, operational readiness, and debugging live\ncluster installations.\n\n\u003e [!NOTE]\n\u003e These are the official AI Skills for Flux CD, developed by the Flux project maintainers.\n\u003e We are looking for users to try them out and provide feedback on accuracy, usefulness, and any gaps when steering Agents through GitOps tasks.\n\u003e If you have suggestions for improvements or new skills, please [open an issue](https://github.com/fluxcd/agent-skills/issues/new).\n\n## Install\n\n### Using Flux Operator CLI\n\nNavigate to your GitOps repository root and run:\n\n```shell\nflux-operator skills install ghcr.io/fluxcd/agent-skills --agent claude-code\n```\n\nThe [Flux Operator](https://fluxoperator.dev/) CLI verifies the cosign signature\n(validating that the OCI artifact is published by the Flux team)\nand extracts the skills in the repo root at `.agents/skills`.\n\nThe `--agent` flag creates per-skill symlinks from agent-specific directories to the canonical\nlocation. If your agent supports the conventional `.agents/skills` path, you can omit the `--agent` flag.\n\nTo update the skills run `flux-operator skills update`.\n\n### Using NPX\n\nInstall the skills with Vercel's skills tool:\n\n```shell\nnpx skills add fluxcd/agent-skills\n```\n\n### Using Claude Code\n\nFor Claude Code, add the marketplace and install the skills with:\n\n```shell\n/plugin marketplace add fluxcd/agent-skills\n/plugin install gitops-skills@fluxcd\n```\n\n## Prerequisites\n\nThe skills in this repository rely on the following tools being available in the environment:\n\n- `flux` for dry running and manifest generation\n- `awk` for text processing and data extraction\n- `yq` for YAML parsing and validation\n- `kustomize` for building kustomize overlays\n- `kubeconform` for validating Kubernetes manifests against OpenAPI schemas\n- `flux-operator-mcp` for debugging Flux on live Kubernetes clusters (required by `gitops-cluster-debug`)\n\nA [Brewfile](https://raw.githubusercontent.com/fluxcd/agent-skills/refs/heads/main/Brewfile) is provided for easy installation of the prerequisites on macOS.\n\n## Available Skills\n\nThe skills are designed to work together and the agent automatically selects the right one\nbased on context: `gitops-knowledge` for answering Flux questions and generating manifests,\n`gitops-repo-audit` for validating and auditing repository contents,\nand `gitops-cluster-debug` for troubleshooting live clusters.\n\n### gitops-knowledge\n\nAnswers questions about Flux CD and generates up-to-date YAML for all Flux custom resources.\nBundled with OpenAPI schemas for every Flux resource and reference documentation covering\nsources, HelmRelease, Kustomization, ResourceSets, image automation, notifications,\nrepository patterns, and the Flux Operator APIs.\n\nTo invoke the skill, use the following prompts:\n\n```text\nWhat's the recommended GitOps structure for a multi-cluster fleet?\n```\n\n```text\nGenerate a HelmRelease for oci://ghcr.io/my-org/frontend,\nand a Kustomization to deploy it in the staging cluster.\n```\n\n```text\nHow do I set up preview environments for pull requests with Flux Operator?\n```\n\nThis skill works best in the context of a GitOps repository that contains an `AGENTS.md`\nor `CLAUDE.md` with details about your organization's structure, cluster topology,\nand secret management approach. The agent combines the skill's reference files with\nthe repository context to generate manifests tailored to your setup.\n\n\u003e [!NOTE]\n\u003e Check the [Claude Code Guide](docs/claude-agent-setup.md) for how to orchestrate Flux CD sub-agents and generate audit reports in HTML format.\n\n### gitops-repo-audit\n\nAudits Flux GitOps repositories for structure, security, and operational best practices.\nValidates manifests against OpenAPI schemas, detects deprecated API versions,\nreviews secrets management, source authentication, RBAC and multi-tenancy configuration,\nand generates a structured report with prioritized recommendations.\n\nTo invoke the skill, use the following prompt:\n\n```text\nAudit the current repo and provide a GitOps report.\n```\n\nIn Claude Code, you can also invoke the skill directly with `/gitops-repo-audit`.\n\nTo run only the manifest validation phase, use:\n\n```text\nValidate my repo without auditing it.\n```\n\nThis prompt can be used when changes have been made to the repository,\nand you want to re-run the validation checks without performing a full audit.\n\nYou can also use the skill to audit only the files with changes:\n\n```text\nRun a GitOps audit only on the files with changes.\n```\n\n### gitops-cluster-debug\n\nDebugs and troubleshoots Flux CD on live Kubernetes clusters using the\n[Flux MCP](https://fluxoperator.dev/mcp-server/) server. Inspects Flux installation health, diagnoses\nHelmRelease and Kustomization failures, analyzes pod logs and traces dependency chains.\n\nTo invoke the skill, use the following prompts:\n\n```text\nCheck the Flux installation on my current cluster.\n```\n\n```text\nDebug the failing HelmRelease podinfo in the apps namespace.\n```\n\n```text\nTroubleshoot the Kustomization flux-system/infra-controllers in the staging cluster.\n```\n\nThe `flux-operator-mcp` server can be configured in Claude Code with:\n\n```bash\nclaude mcp add --scope project --transport stdio flux-operator-mcp \\\n  --env KUBECONFIG=$HOME/.kube/config \\\n  -- flux-operator-mcp serve --read-only\n```\n\nNote that the `--read-only` flag will prevent the Agent from making any changes to the cluster.\nThe MCP server masks Kubernetes Secrets, the Agent receives only the data key names without values.\n\n## 3rd-Party Indexing\n\nThe Flux skills are indexed by various 3rd-party services:\n\n- [tessl.io/registry/skills/github/fluxcd/agent-skills](https://tessl.io/registry/skills/github/fluxcd/agent-skills)\n- [skills.sh/fluxcd/agent-skills](https://skills.sh/fluxcd/agent-skills)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluxcd%2Fagent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffluxcd%2Fagent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluxcd%2Fagent-skills/lists"}