Agent skill
argocd
GitOps continuous delivery for Kubernetes with ArgoCD. Use when creating/managing ArgoCD Applications, ApplicationSets, App of Apps patterns, Helm/Kustomize deployments, sync configurations, RBAC/projects setup, notifications, health checks, or private repository configuration.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/argocd
SKILL.md
ArgoCD
Declarative GitOps continuous delivery for Kubernetes. ArgoCD continuously monitors Git repositories and automatically syncs application state to match desired configuration.
Quick Start
Install ArgoCD:
kubectl create namespace argocd
kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
Access UI:
kubectl port-forward svc/argocd-server -n argocd 8080:443
# Get initial admin password
argocd admin initial-password -n argocd
CLI Login:
argocd login localhost:8080 --insecure
Core Concepts
| Concept | Description |
|---|---|
| Application | Kubernetes resource tracking a Git repo path to a cluster/namespace |
| AppProject | Logical grouping with source/destination restrictions and RBAC |
| ApplicationSet | Template for generating multiple Applications from generators |
| Sync | Process of applying Git manifests to cluster |
| Health | Status assessment of deployed resources |
Task Reference
Application Management
- Create, sync, delete Applications → references/applications.md
- App of Apps pattern → references/applications.md
Multi-Cluster & Templating
- ApplicationSets with generators → references/applicationsets.md
- List, Cluster, Git, Matrix generators → references/applicationsets.md
Manifest Tools
- Helm charts, values, OCI registries → references/helm.md
- Kustomize overlays, patches → references/kustomize.md
Sync Configuration
- Sync waves, hooks, phases → references/sync-options.md
- Prune, replace, server-side apply → references/sync-options.md
Operations & Admin
- RBAC policies, roles → references/operations.md
- Projects, health checks, notifications → references/operations.md
Repository Setup
- Private repos, SSH, HTTPS, GitHub App → references/repositories.md
- Credential templates, certificates → references/repositories.md
Troubleshooting
- Common issues, FAQ → references/troubleshooting.md
Common CLI Commands
# Application management
argocd app create <name> --repo <url> --path <path> --dest-server https://kubernetes.default.svc --dest-namespace <ns>
argocd app sync <name>
argocd app get <name>
argocd app delete <name>
argocd app list
# Cluster management
argocd cluster add <context-name>
argocd cluster list
# Repository management
argocd repo add <url> [--ssh-private-key-path | --username/--password]
argocd repo list
# Project management
argocd proj create <name> -d <server>,<namespace> -s <repo-url>
argocd proj list
Minimal Application Example
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
name: myapp
namespace: argocd
spec:
project: default
source:
repoURL: https://github.com/org/repo.git
targetRevision: HEAD
path: manifests
destination:
server: https://kubernetes.default.svc
namespace: myapp
syncPolicy:
automated:
prune: true
selfHeal: true
syncOptions:
- CreateNamespace=true
Official Documentation
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?