K8

Control GitOps synchronization and reconciliation workflows for Flux and ArgoCD deployments.

Install

mkdir -p .claude/skills/k8s-gitops && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/3859" && unzip -o skill.zip -d .claude/skills/k8s-gitops && rm skill.zip

Installs to .claude/skills/k8s-gitops

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Manage GitOps workflows with Flux and ArgoCD. Use for sync status, reconciliation, app management, source management, and GitOps troubleshooting.
145 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • →List and verify Flux kustomizations
  • →Trigger manual reconciliation for GitOps resources
  • →List and inspect ArgoCD application status
  • →Suspend and resume GitOps reconciliation
  • →Detect drift between live and desired state

How it works

It interfaces with Flux and ArgoCD APIs to retrieve synchronization states and trigger reconciliation loops for specific resources.

Inputs & outputs

You give it
application name and namespace
You get back
synchronization status and health report

When to use k8s-gitops

  • →Checking Flux sync status
  • →Reconciling deployments after Git changes
  • →Troubleshooting out-of-sync ArgoCD applications
  • →Suspending reconciliation for manual debugging

About this skill

Kubernetes GitOps

GitOps workflows using Flux and ArgoCD with kubectl-mcp-server tools.

Requires the gitops toolset: start kubectl-mcp-server with --toolsets default,gitops (or MCP_TOOLSETS=default,gitops). For deep work, the project-maintained MCP servers may fit better: Argo CD: https://github.com/argoproj-labs/mcp-for-argocd; Flux: https://fluxoperator.dev/mcp-server/.

When to Apply

Use this skill when:

  • User mentions: "Flux", "ArgoCD", "GitOps", "sync", "reconcile"
  • Operations: checking sync status, triggering reconciliation, drift detection
  • Keywords: "out of sync", "deploy from git", "continuous delivery"

Priority Rules

PriorityRuleImpactTools
1Check source readiness before troubleshootingCRITICALgitops_sources_list
2Verify sync status before deploymentsHIGHgitops_app_get
3Reconcile after git changesMEDIUMgitops_app_sync
4Suspend before manual changesLOWkubectl_patch

Quick Reference

TaskToolExample
List Flux kustomizationsgitops_apps_listgitops_apps_list(namespace)
Reconcile Fluxgitops_app_syncgitops_app_sync(kind, name, namespace)
List ArgoCD appsgitops_apps_listgitops_apps_list(namespace)
Sync ArgoCDgitops_app_syncgitops_app_sync(name, namespace)

Flux CD

Check Flux Status

gitops_apps_list(namespace="flux-system")
gitops_apps_list(namespace)
gitops_sources_list(namespace="flux-system")

Reconcile Resources

gitops_app_sync(
    kind="kustomization",
    name="my-app",
    namespace="flux-system"
)

gitops_app_sync(
    kind="helmrelease",
    name="my-chart",
    namespace="default"
)

Suspend/Resume

kubectl_patch(resource_type="kustomization", name="my-app", namespace="flux-system", patch={"spec": {"suspend": true}}, patch_type="merge")

kubectl_patch(resource_type="kustomization", name="my-app", namespace="flux-system", patch={"spec": {"suspend": false}}, patch_type="merge")

See FLUX.md for detailed Flux workflows.

ArgoCD

List Applications

gitops_apps_list(namespace="argocd")

Get App Status

gitops_app_get(kind="application", name="my-app", namespace="argocd")

Sync Application

gitops_app_sync(kind="application", name="my-app", namespace="argocd")

Refresh App

gitops_app_sync(kind="application", name="my-app", namespace="argocd")

See ARGOCD.md for detailed ArgoCD workflows.

GitOps Troubleshooting

Flux Not Syncing

SymptomCheckResolution
Source not readygitops_sources_list()Check git credentials
Kustomization failedgitops_apps_list()Check manifest errors
HelmRelease failedgitops_apps_list()Check values, chart version

ArgoCD Out of Sync

SymptomCheckResolution
OutOfSyncgitops_app_get()Manual sync or check auto-sync
DegradedCheck health statusFix unhealthy resources
UnknownRefresh appgitops_app_sync()

Environment Promotion

With Flux Kustomizations

gitops_app_sync(kind="kustomization", name="staging", namespace="flux-system")

gitops_app_sync(kind="kustomization", name="production", namespace="flux-system")

With ArgoCD

gitops_app_sync(kind="application", name="app-staging", namespace="argocd")

gitops_app_get(kind="application", name="app-staging", namespace="argocd")

gitops_app_sync(kind="application", name="app-production", namespace="argocd")

Multi-Cluster GitOps

Manage GitOps across clusters:

gitops_apps_list(namespace="flux-system", context="cluster-1")
gitops_apps_list(namespace="flux-system", context="cluster-2")

gitops_app_sync(
    kind="kustomization",
    name="apps",
    namespace="flux-system",
    context="production-cluster"
)

Drift Detection

Compare live state with desired:

gitops_app_get(kind="application", name="my-app", namespace="argocd")

gitops_apps_list(namespace="flux-system")

Prerequisites

  • Flux: Required for Flux tools
    flux install
    
  • ArgoCD: Required for ArgoCD tools
    kubectl create namespace argocd
    kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
    

Related Skills

When not to use it

  • →Directly modifying application source code
  • →Managing non-GitOps deployments

Prerequisites

Flux CD installationArgoCD installation

Limitations

  • →Dependent on controller health
  • →Limited to supported GitOps tools

How it compares

It provides a unified interface for managing multiple GitOps controllers, avoiding the need to switch between different CLI tools for status checks.

Compared to similar skills

k8s-gitops side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
k8s-gitops (this skill)19moReviewIntermediate
k8s-operations19moReviewIntermediate
linkerd-patterns68moReviewAdvanced
storage-networking610moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

More by rohitg00

View all by rohitg00 →

You might also like

k8s-operations

rohitg00

kubectl operations for applying, patching, deleting, and executing commands on Kubernetes resources. Use when modifying resources, running commands in pods, or managing resource lifecycle.

10

linkerd-patterns

wshobson

Implement Linkerd service mesh patterns for lightweight, security-focused service mesh deployments. Use when setting up Linkerd, configuring traffic policies, or implementing zero-trust networking with minimal overhead.

672

storage-networking

pluginagentmarketplace

Master Kubernetes storage management and networking architecture. Learn persistent storage, network policies, service discovery, and ingress routing.

663

k8s-helm

rohitg00

Manage Helm charts, releases, and repositories. Use for Helm installations, upgrades, rollbacks, chart development, and release management.

857

kubernetes-architect

sickn33

Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration. Masters EKS/AKS/GKE, service mesh (Istio/Linkerd), progressive delivery, multi-tenancy, and platform engineering. Handles security, observability, cost optimization, and developer experience. Use PROACTIVELY for K8s architecture, GitOps implementation, or cloud-native platform design.

636

gitlab-ci-patterns

wshobson

Build GitLab CI/CD pipelines with multi-stage workflows, caching, and distributed runners for scalable automation. Use when implementing GitLab CI/CD, optimizing pipeline performance, or setting up automated testing and deployment.

1030

Search skills

Search the agent skills registry