Skip to content
cccskills
FreePublished on GitHub

k8s-gitops

Manage GitOps workflows with Flux and ArgoCD. Use for sync status, reconciliation, app management, source management, and GitOps troubleshooting.

The English summary is being prepared. Showing the original description.

Works withKubernetes
See how to install

Files included (3)

  • SKILL.md4.5 KB
  • ARGOCD.md3.4 KB
  • FLUX.md3.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Kubernetes GitOps

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

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 troubleshootingCRITICALflux_sources_list_tool
2Verify sync status before deploymentsHIGHargocd_app_get_tool
3Reconcile after git changesMEDIUMflux_reconcile_tool
4Suspend before manual changesLOWflux_suspend_tool

Quick Reference

TaskToolExample
List Flux kustomizationsflux_kustomizations_list_toolflux_kustomizations_list_tool(namespace)
Reconcile Fluxflux_reconcile_toolflux_reconcile_tool(kind, name, namespace)
List ArgoCD appsargocd_apps_list_toolargocd_apps_list_tool(namespace)
Sync ArgoCDargocd_sync_toolargocd_sync_tool(name, namespace)

Flux CD

Check Flux Status

flux_kustomizations_list_tool(namespace="flux-system")
flux_helmreleases_list_tool(namespace)
flux_sources_list_tool(namespace="flux-system")

Reconcile Resources

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

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

Suspend/Resume

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

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

See FLUX.md for detailed Flux workflows.

ArgoCD

List Applications

argocd_apps_list_tool(namespace="argocd")

Get App Status

argocd_app_get_tool(name="my-app", namespace="argocd")

Sync Application

argocd_sync_tool(name="my-app", namespace="argocd")

Refresh App

argocd_refresh_tool(name="my-app", namespace="argocd")

See ARGOCD.md for detailed ArgoCD workflows.

GitOps Troubleshooting

Flux Not Syncing

SymptomCheckResolution
Source not readyflux_sources_list_tool()Check git credentials
Kustomization failedflux_kustomizations_list_tool()Check manifest errors
HelmRelease failedflux_helmreleases_list_tool()Check values, chart version

ArgoCD Out of Sync

SymptomCheckResolution
OutOfSyncargocd_app_get_tool()Manual sync or check auto-sync
DegradedCheck health statusFix unhealthy resources
UnknownRefresh appargocd_refresh_tool()

Environment Promotion

With Flux Kustomizations

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

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

With ArgoCD

argocd_sync_tool(name="app-staging", namespace="argocd")

argocd_app_get_tool(name="app-staging", namespace="argocd")

argocd_sync_tool(name="app-production", namespace="argocd")

Multi-Cluster GitOps

Manage GitOps across clusters:

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

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

Drift Detection

Compare live state with desired:

argocd_app_get_tool(name="my-app", namespace="argocd")

flux_kustomizations_list_tool(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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Configure Kubernetes autoscaling with HPA, VPA, and KEDA. Use for horizontal/vertical pod autoscaling, event-driven scaling, and capacity management.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

Kubernetes backup and restore with Velero. Use when creating backups, restoring applications, managing disaster recovery, or migrating workloads between clusters.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

Browser automation for Kubernetes dashboards and web UIs. Use when interacting with Kubernetes Dashboard, Grafana, ArgoCD UI, or other web interfaces. Requires MCP_BROWSER_ENABLED=true.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

Cluster API lifecycle management for provisioning, scaling, and upgrading Kubernetes clusters. Use when managing cluster infrastructure or multi-cluster operations.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

Kubernetes certificate management with cert-manager. Use when managing TLS certificates, configuring issuers, or troubleshooting certificate issues.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

Cilium and Hubble network observability for Kubernetes. Use when managing network policies, observing traffic flows, or troubleshooting connectivity with eBPF-based networking.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Apr 9, 2026

See all skills by rohitg00

Report a problem with this skill