PlugWiki

gitops-workflow Skill for Claude Code: GitOps With ArgoCD and Flux

Teaches Claude to set up GitOps for Kubernetes with ArgoCD or Flux, so deployments come from Git and are reconciled automatically.

Installs
11.9K
on skills.sh
Stars
42.1K
on GitHub
Files
2
besides SKILL.md
Updated
Oct 2026
last repo commit

gitops-workflow is a guide for declarative, Git-based delivery to Kubernetes. It explains the four OpenGitOps principles, then walks through ArgoCD (install, repo layout, an Application, the app-of-apps pattern) and Flux (install, bootstrap, GitRepository and Kustomization). It also covers sync policies, canary and blue-green rollouts, secrets with External Secrets Operator or Sealed Secrets, and troubleshooting.

It triggers when you ask about GitOps, ArgoCD, Flux or automated Kubernetes deployments. The folder holds 3 Markdown files and no scripts, but the commands it shows change a real cluster. See the permissions section.

Good for

  • Platform and DevOps engineers moving Kubernetes deploys to Git
  • Teams choosing between ArgoCD and Flux for continuous delivery
  • Anyone who needs secrets handled safely in a GitOps repo

Install gitops-workflow

Claude Code

  1. 1

    Copy this prompt.

    Install the gitops-workflow skill in Claude Code. Run this command:

/plugin marketplace add wshobson/agents
/plugin install kubernetes-operations@claude-code-workflows

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The kubernetes-operations plugin adds 3 more Kubernetes skills and the kubernetes-architect agent. The skills-only route installs just this skill, without the plugin's agents or commands (README).

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

Implement GitOps workflows with ArgoCD and Flux for automated, declarative Kubernetes deployments with continuous reconciliation. Use when implementing GitOps practices, automating Kubernetes deployments, or setting up declarative infrastructure management.

Sections in SKILL.md

  1. Purpose
  2. When to Use This Skill
  3. OpenGitOps Principles
  4. ArgoCD Setup
  5. 1. Installation
  6. 2. Repository Structure
  7. 3. Create Application
  8. 4. App of Apps Pattern
  9. Flux CD Setup
  10. 1. Installation
  11. 2. Create GitRepository
  12. 3. Create Kustomization
  13. Sync Policies
  14. Auto-Sync Configuration
  15. Progressive Delivery
  16. Canary Deployment with ArgoCD Rollouts

Key facts

Author
Seth Hobson
Repo
wshobson/agents
License
MIT
Installs on skills.sh
11,910 (Nov 2, 2026)
GitHub stars
42,081 (Nov 2, 2026), whole repo
Last commit
Oct 30, 2026 (repo)
Files in the skill folder
3 files including SKILL.md
Part of
kubernetes-operations plugin: 1 agent, 4 skills
Works in
Claude Code and Codex plugins; skills-only installers for other tools

What it includes

  • Four rules: declarative, versioned, pulled automatically, continuously reconciled.

    The base the rest of the skill builds on.

    OpenGitOps principles

  • Installs ArgoCD and shows the repo layout and an Application manifest.

    Runs kubectl create and kubectl apply against your cluster.

    Runs code · ArgoCD setup

  • One parent Application that manages the others.

    Keeps many apps organized.

    App of Apps pattern

  • Installs the Flux CLI, bootstraps it on GitHub, and creates source and sync objects.

    Bootstrap writes to your GitHub repo.

    Runs code · Flux setup

  • Auto-sync, prune, self-heal and retry settings for ArgoCD and Flux.

    Prune deletes resources that are not in Git.

    Delete · Sync policies

  • Canary and blue-green rollouts with Argo Rollouts.

    Shows canary steps at 20, 50 and 100 percent weight.

    Progressive delivery

  • External Secrets Operator and Sealed Secrets.

    Keeps plain secrets out of Git.

    Secret management

  • argocd app get, sync and diff commands for failures and drift.

    Includes sync --prune and sync --force.

    Delete · Troubleshooting

  • Install methods, access, ingress, CLI login, SSO with GitHub OAuth and RBAC.

    In references/argocd-setup.md.

    Runs code · ArgoCD reference

  • Sync windows, retry, health checks and sync options.

    In references/sync-policies.md.

    Sync policies reference

  • A 10-point list, from separate environments to testing in staging first.

    Ends the SKILL.md.

    Best practices

From the official docs

Permissions

Medium risk

The commands in this skill install ArgoCD or Flux into a Kubernetes cluster, bootstrap a GitHub repository and can prune live resources. Use a test cluster first and approve each command.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It applies a manifest straight from the internet

    The ArgoCD install runs kubectl apply -f against a raw.githubusercontent.com URL for the stable ArgoCD manifest. Pin a version and read the manifest first. github.com

  • Prune and force sync can delete resources

    The examples set prune: true and the troubleshooting uses argocd app sync --prune and --force. Check the target app and cluster before running them. github.com

  • Flux bootstrap writes to GitHub

    flux bootstrap github with --owner, --repository and --personal pushes Flux files to your GitHub repo. The Homebrew step before it is also a package install. github.com

  • It prints the ArgoCD admin password

    The SKILL.md prints the initial ArgoCD admin password from a Kubernetes secret. Do not paste it into chat. github.com

Technical details
Talks toraw.githubusercontent.com. github.com
Scopes

  • kubectl access to your current cluster context

  • GitHub access for flux bootstrap

Questions

What does gitops-workflow do?

It teaches Claude to set up GitOps for Kubernetes using ArgoCD or Flux. That covers installing the tool, laying out the Git repo, writing sync policies, rolling out changes gradually and managing secrets.

How do I install it?

Use the install box above. The README offers the kubernetes-operations plugin, which adds 3 more skills and an agent, or a skills-only install of just this skill.

ArgoCD or Flux?

The skill covers both and does not pick one. It gives setup steps for each and sync settings for each.

Does it work in Claude.ai, Codex or Cursor?

The README documents Claude Code and Codex plugins and a Cursor plugin marketplace, plus skills-only installers for other tools. It does not describe the Claude app.

Is it safe?

The skill bundles no scripts, but the commands it shows install software into a cluster, bootstrap a GitHub repo and can delete resources. Point Claude at a test cluster first and read each command before approving it.

Can it delete things in my cluster?

Its examples turn on prune, which deletes resources missing from Git, and its troubleshooting uses argocd app sync with --prune and --force. Those only run if Claude runs them against your cluster.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/kubernetes-operations/skills/gitops-workflow

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5
  1. wshobson/agents README · github.com
  2. gitops-workflow SKILL.md · github.com
  3. argocd-setup.md · github.com
  4. sync-policies.md · github.com
  5. kubernetes-operations plugin.json · github.com

Updated Nov 2, 2026.