devops:argocd-ops

Diagnose ArgoCD sync failures, OutOfSync states, and configuration drift.

Updated Feb 27, 2026
One-click install
npx skills add https://github.com/ChanghwanK/dotfiles --skill devops-argocd-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devops:argocd-ops
Source: https://github.com/ChanghwanK/dotfiles/tree/main/claude/.claude/skills/devops%3Aargocd-ops
Command: npx skills add https://github.com/ChanghwanK/dotfiles --skill devops-argocd-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kubectl, argocd, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you systematically diagnose and resolve common ArgoCD issues such as sync failures, OutOfSync states, and degraded application health, ensuring your GitOps deployments are stable and reliable.

Core Features & Use Cases

  • Application Status Check: Quickly assess the sync and health status of your ArgoCD applications.
  • Sync Error Analysis: Pinpoint the root cause of sync failures, whether they stem from Git discrepancies, Kubernetes resource issues, or webhook rejections.
  • Drift Detection: Identify and understand configuration drift between your Git repository and the live cluster state.
  • ApplicationSet Validation: Verify that ApplicationSets are correctly generating applications and troubleshoot issues in the deployment chain.
  • Use Case: When an ArgoCD application shows as 'OutOfSync' and 'Degraded', this Skill guides you through checking diffs, analyzing sync errors, and examining resource statuses to find the exact problem.

Quick Start

Diagnose the 'ai-gateway.infra-k8s-prod' ArgoCD application for sync issues.

Frequently Asked Questions about devops:argocd-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose ArgoCD sync failures and degraded application health?

To diagnose ArgoCD sync failures, you analyze application status, sync errors, and resource differences. This process identifies configuration drift between your Git repository and the live Kubernetes cluster state to pinpoint root causes.

What causes an ArgoCD application to be OutOfSync?

An ArgoCD application becomes OutOfSync due to configuration drift between your Git repository and live Kubernetes cluster state. Identifying these resource differences and Git discrepancies is essential for restoring synchronization.

How do I troubleshoot ArgoCD ApplicationSet generation issues?

Troubleshooting ArgoCD ApplicationSet issues requires validating that ApplicationSets correctly generate applications. You must examine the deployment chain and ApplicationSet configurations to find errors preventing proper application creation.

Do I need kubectl and argocd CLI to troubleshoot GitOps deployment issues?

Yes, resolving ArgoCD GitOps deployment issues requires kubectl and argocd CLI. You also need an understanding of Kubernetes resource manifests and Helm or Kustomize to effectively analyze sync errors and resource statuses.

Why is my ArgoCD sync operation rejected by a webhook?

ArgoCD sync operations fail when webhook rejections occur alongside Git discrepancies or Kubernetes resource issues. Analyzing application status and sync error logs helps identify the exact failure point in the deployment chain.