Add gitops-argo-cd agent skill

Consolidates the five cogarchhubgitops-* source skills into one skill with scope routing: ArgoCD Applications, Copier templates, Helm values, environment answer files, and the end-to-end resource-addition walkthrough. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-29 23:48:32 +03:00
parent 89a9cf9320
commit 50d746d03f
11 changed files with 1615 additions and 1 deletions
@@ -1 +1,50 @@
-# gitops-argo-cd
+# gitops-argo-cd
+
+Agent Skill for GitOps repositories where **ArgoCD** syncs cluster state from a
+**Copier**-templated Git repo — app-of-apps `Application` manifests under `cluster/argocd/`,
+Helm `values.yaml.jinja` templates under `cluster/resources/`, Jinja2 conditional directory
+names used as feature flags, and per-environment `copier-answers.yaml` files.
+
+The rules are repo-agnostic; `references/cogarchhubgitops-reference.md` records
+CogArchHubGitOps as the concrete reference implementation (bands in use, flag names, global
+settings, ordering dependencies).
+
+## Layout
+
+```text
+gitops-argo-cd/
+├── SKILL.md                                  # Entry point — scope routing + shared rules
+├── references/
+│   ├── argocd-applications.md                # Application manifests, sync policy, troubleshooting
+│   ├── copier-templates.md                   # copier.yaml, .jinja authoring, render() macro
+│   ├── helm-values.md                        # values.yaml.jinja, images, global block, probes
+│   ├── environments.md                       # copier-answers.yaml, flags, drift, copier update
+│   ├── adding-a-resource.md                  # End-to-end walkthrough across all three layers
+│   └── cogarchhubgitops-reference.md         # The CogArchHubGitOps instance
+└── assets/
+    └── example-cluster-resource/             # Starting templates for a new resource
+        ├── argocd/application.yaml.jinja
+        ├── resources/values.yaml.jinja
+        └── copier-variables.yaml
+```
+
+## The three-layer contract
+
+Every managed resource spans three layers that share one feature flag and one conditional
+directory expression:
+
+```text
+copier.yaml                                            → declares the flag + variables
+cluster/argocd/{{ 'NNN-name' if flag }}/               → ArgoCD Application
+cluster/resources/{{ 'NNN-name' if flag }}/            → Helm values
+```
+
+## Deploy
+
+```bash
+cd ../skill-manager/scripts
+task deploy -- --skill-dir="$(cd ../../gitops-argo-cd && pwd)"
+```
+
+Built with the `skill-manager` skill, following the
+[agentskills.io specification](https://agentskills.io/specification).