Agent skill

gitops

GitOps workflows for this repo: edit Argo CD/Kubernetes/infra manifests in version control, validate changes, and rely on Argo CD to sync. Use when tasks touch argocd/, kubernetes/, tofu/, ansible/, or deployment/runbook changes, or when asked to roll out services via GitOps.

View SKILL.md on GitHub Repository
Stars 7
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/proompteng/lab/tree/main/skills/gitops

SKILL.md

GitOps

Overview

Use GitOps-first changes for infra and deployment workflows, then validate locally and let Argo CD reconcile. Only apply directly to the cluster when explicitly instructed or in an emergency.

Workflow

  1. Locate the source of truth

    • Argo CD apps and overlays: argocd/
    • Kubernetes manifests: kubernetes/
    • IaC: tofu/, ansible/
    • Service-specific instructions: nearest README.md

  2. Edit manifests in Git

    • Prefer updating Argo CD apps/overlays instead of raw kubectl applies.
    • Keep environment-specific changes in overlays.

  3. Validate locally

    • Argo lint: scripts/argo-lint.sh
    • Kubeconform: scripts/kubeconform.sh argocd
    • Terraform/tofu: bun run tf:plan (apply only when asked)
    • Ansible: bun run ansible

  4. Rollout discipline

  • Note rollout/impact for changes in argocd/, kubernetes/, tofu/, ansible/.
  • For Helm charts with kustomize, use: mise exec helm@3 -- kustomize build --enable-helm <path>.
  1. Cluster access (exception-only)
  • Use direct kubectl apply only when explicitly asked or in emergencies.
  • Always set namespace: kubectl ... -n <ns>.
  1. Deploy completion guardrail
    • Only call a deploy "completed" after the Argo CD application is synced and healthy.

Pointers

  • Use references/gitops-checklist.md for quick commands and repo-specific notes.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

proompteng/lab

temporal

Operate Temporal workflows with explicit namespace/address: inspect runs, fetch history, debug nondeterminism, reset/cancel/terminate, and inspect task queues.

7 0
Explore
proompteng/lab

news-sentiment

Extract structured, source-attributed sentiment context for one symbol.

7 0
Explore
proompteng/lab

research-brief

Generate a concise research brief with uncertainty and citations.

7 0
Explore
proompteng/lab

memories

Save and retrieve memories or embeddings via the repo helpers or API. Use when working with embedding config or memory storage.

7 0
Explore
proompteng/lab

repo-map

Navigate this repo quickly to find the correct app, package, or service, and identify the right files for changes.

7 0
Explore
proompteng/lab

kubernetes

Use for kubectl, CNPG, and kustomize/helm operations in this repo, including rollouts and cluster debugging.

7 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results