Agent skill

Building Gitops Workflows

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Execute use when constructing GitOps workflows using ArgoCD or Flux.

MITAuto-check passedDevOps & Cloud

Install Building Gitops Workflows

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill building-gitops-workflows -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace building-gitops-workflows --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/building-gitops-workflows .claude/skills/building-gitops-workflows && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
building-gitops-workflows
GitHub stars
2.8k
Token cost
~1.1k tokens
SKILL.md length
487 words
Files
4 (incl. scripts, references, assets)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Execute use when constructing GitOps workflows using ArgoCD or Flux.

  • Works in 9 steps: Choose the GitOps tool based on… → Design the repository structure:… → Generate ArgoCD Application or Flux… → …
  • Constructing GitOps workflows using ArgoCD
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Calls argocd

What it does

Building Gitops Workflows is an agent skill from jeremylongshore/tons-of-skills-marketplace. Execute use when constructing GitOps workflows using ArgoCD or Flux. Trigger with phrases like "create GitOps workflow", "setup ArgoCD", "configure Flux", or "automate Kubernetes deployments". Generates production-ready configurations, implements best practices, and ensures security-first approach for continuous deployment.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts, reference files and assets (for example `assets/README.md`, `references/README.md` and `scripts/README.md`). Compatibility notes: Designed for Claude Code

It sits in DevOps & Cloud, covering Container orchestration, GitOps and CI/CD. It works with Argo CD, Kubernetes and Git. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Constructing GitOps workflows using ArgoCD
  • With phrases like create GitOps workflow
  • Automate Kubernetes deployments

Example prompts

  • “create GitOps workflow”
  • “setup ArgoCD”
  • “configure Flux”
  • “/building-gitops-workflows”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash(kubectl:*), Bash(git:*)

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Choose the GitOps tool based on requirements: ArgoCD for UI-driven management, Flux for lightweight Git-native approach
  2. Design the repository structure: environments/{dev,staging,prod}/ with Kustomize overlays or Helm values per environment
  3. Generate ArgoCD Application or Flux Kustomization manifests pointing to the Git repository path for each environment
  4. Configure sync policy: enable automated.selfHeal and automated.prune for non-production; use manual sync for production
  5. Set up Git repository credentials as a Kubernetes Secret for the GitOps operator
  6. Implement environment promotion: update the image tag in staging manifests, test, then promote to production via PR
  7. Configure notifications: Slack/email alerts on sync success, failure, or health degradation via ArgoCD Notifications or Flux Alert Provider
  8. Add RBAC: restrict who can sync production applications and who can modify GitOps configurations
  9. Validate the setup: push a manifest change to Git and verify the GitOps operator detects and applies it within the sync interval

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Glob
    • Bash(kubectl:*)
    • Bash(git:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • argocd

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • argo-cd.readthedocs.io
    • fluxcd.io
    • opengitops.dev
    • kustomize.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Building Gitops Workflows loads about 1.1k tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 88 tokens; SKILL.md has 487 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 487 words, ~1,107 tokens.

Download SKILL.mdSave it as .claude/skills/building-gitops-workflows/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
building-gitops-workflows
description
Execute use when constructing GitOps workflows using ArgoCD or Flux. Trigger with phrases like "create GitOps workflow", "setup ArgoCD", "configure Flux", or "automate Kubernetes deployments". Generates production-ready configurations, implements best practices, and ensures security-first approach for continuous deployment.
allowed-tools
Read, Write, Edit, Grep, Glob, Bash(kubectl:*), Bash(git:*)
compatibility
Designed for Claude Code
version
1.22.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
tags
devops, deployment, kubernetes, security

Building GitOps Workflows

Overview

Construct GitOps workflows using ArgoCD or Flux to implement declarative, Git-driven continuous delivery for Kubernetes. Generate Application/Kustomization manifests, configure sync policies, set up multi-environment promotion, and implement RBAC and notification integrations.

Prerequisites

  • Kubernetes cluster accessible via kubectl with admin permissions
  • Git repository for storing Kubernetes manifests (separate from application code recommended)
  • ArgoCD or Flux installed on the cluster, or Helm charts ready for installation
  • Container images built and pushed to a registry accessible from the cluster
  • SSH key or access token for Git repository authentication from the cluster

Instructions

  1. Choose the GitOps tool based on requirements: ArgoCD for UI-driven management, Flux for lightweight Git-native approach
  2. Design the repository structure: environments/{dev,staging,prod}/ with Kustomize overlays or Helm values per environment
  3. Generate ArgoCD Application or Flux Kustomization manifests pointing to the Git repository path for each environment
  4. Configure sync policy: enable automated.selfHeal and automated.prune for non-production; use manual sync for production
  5. Set up Git repository credentials as a Kubernetes Secret for the GitOps operator
  6. Implement environment promotion: update the image tag in staging manifests, test, then promote to production via PR
  7. Configure notifications: Slack/email alerts on sync success, failure, or health degradation via ArgoCD Notifications or Flux Alert Provider
  8. Add RBAC: restrict who can sync production applications and who can modify GitOps configurations
  9. Validate the setup: push a manifest change to Git and verify the GitOps operator detects and applies it within the sync interval

Output

  • ArgoCD Application or Flux Kustomization manifests per environment
  • Git repository structure with Kustomize bases and overlays
  • RBAC configuration (ArgoCD AppProject, Kubernetes RBAC)
  • Notification configuration (Slack webhooks, email)
  • CI pipeline step to update image tags in the GitOps repository after build
Show full SKILL.md (201 more words)Show less

Error Handling

ErrorCauseSolution
ComparisonError: Failed to load target stateInvalid manifest path or Git refVerify path: and targetRevision: in the Application manifest; check repo structure
Authentication failed for repositorySSH key or token not configured or expiredCreate/update the Git credentials Secret; verify deploy key has read access
Application is OutOfSync but not syncingAutomated sync disabled or sync window closedEnable automated: in syncPolicy or trigger manual sync with argocd app sync
Resource already exists and is not managedResource created outside of GitOpsAdd the argocd.argoproj.io/managed-by annotation or delete the conflicting resource
Sync failed: health check timeoutApplication pods not becoming ready after syncCheck pod logs; verify resource requests fit node capacity; increase health check timeout

Examples

  • "Set up ArgoCD with three Application manifests for dev, staging, and production, each pointing to a different Kustomize overlay in the GitOps repo."
  • "Configure Flux with automatic image updates: scan ECR for new tags matching v*, update the staging manifests, and create a PR for production promotion."
  • "Create an ArgoCD AppProject that restricts the production application to specific namespaces and requires manual sync with admin-only access."

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references, assets) in skills/.curated/building-gitops-workflows of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • assets/README.md
  • references/README.md
  • scripts/README.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Building Gitops Workflows next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Building Gitops Workflows compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Building Gitops Workflows this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
Implementing Gitopsancoleman/ai-design-components526—~2.9kAutomated safety check: PassMIT
GitOps with ArgoCD and Fluxwshobson/agents40k12 repos~1.5kAutomated safety check: PassMIT
Argocd GitopsBagelHole/DevOps-Security-Agent-Skills1.1k—~2.4kAutomated safety check: PassMIT
Argocd Gitopssickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
Devops Automationrohitg00/awesome-claude-code-toolkit2.7k—~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Implementing Gitops

    ancoleman/ai-design-components

    Implement GitOps continuous delivery for Kubernetes using ArgoCD or Flux.

    526 GitHub stars~2.9k tokensUpdated 10 mo ago
    DevOps & CloudAuto-check passed
  • Sets up GitOps continuous delivery for Kubernetes with ArgoCD or Flux, covering installation, repository layout, sync policies, progressive delivery and secrets.

    40k GitHub starsUsed in 12 repos~1.5k tokens
    DevOps & CloudAuto-check passed
  • Argocd Gitops

    BagelHole/DevOps-Security-Agent-Skills

    Implement GitOps with ArgoCD for declarative Kubernetes deployments.

    1.1k GitHub stars~2.4k tokensUpdated 4 mo ago
    DevOps & CloudAuto-check passed
  • Argocd Gitops

    sickn33/agentic-awesome-skills

    Implement GitOps with ArgoCD for declarative Kubernetes deployments.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    DevOps & CloudAuto-check passed
  • Devops Automation

    rohitg00/awesome-claude-code-toolkit

    CI/CD pipeline design with GitHub Actions, Docker, Kubernetes, Helm, and GitOps patterns

    2.7k GitHub stars~1.6k tokensUpdated 5 mo ago
    DevOps & CloudAuto-check passed
  • KubeSphere DevOps Overview

    kubesphere/kubesphere

    Explains the KubeSphere DevOps extension: Jenkins-based CI/CD, ArgoCD GitOps, how DevOps projects map to namespaces, and project naming rules.

    17k GitHub stars~3.1k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Building Gitops Workflows

What does Building Gitops Workflows do?

Execute use when constructing GitOps workflows using ArgoCD or Flux. Building Gitops Workflows is an agent skill from jeremylongshore/tons-of-skills-marketplace. Execute use when constructing GitOps workflows using ArgoCD or Flux.

When should I use Building Gitops Workflows?

Building Gitops Workflows fits situations like: constructing GitOps workflows using ArgoCD; with phrases like create GitOps workflow; automate Kubernetes deployments.

How do I install Building Gitops Workflows in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill building-gitops-workflows -a claude-code`. Or copy the skill folder (skills/.curated/building-gitops-workflows in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/building-gitops-workflows in your project. Claude Code loads it when a task matches its description.

How do I install Building Gitops Workflows in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill building-gitops-workflows -a codex`. Or copy the skill folder (skills/.curated/building-gitops-workflows in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/building-gitops-workflows in your project. Codex loads it when a task matches its description.

Can I use Building Gitops Workflows in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill building-gitops-workflows -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/building-gitops-workflows, .gemini/skills/building-gitops-workflows, .github/skills/building-gitops-workflows and .opencode/skills/building-gitops-workflows in your project.

What does Building Gitops Workflows need to run?

Going by SKILL.md and its folder, Building Gitops Workflows needs the command-line tools its instructions call (argocd). Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob, Bash(kubectl:*), Bash(git:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Building Gitops Workflows access the network?

SKILL.md names 4 domains. As links in the text: argo-cd.readthedocs.io, fluxcd.io, opengitops.dev and kustomize.io. This is read from the text; nothing was executed.

Is Building Gitops Workflows safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Building Gitops Workflows use?

Building Gitops Workflows is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Building Gitops Workflows use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 17 tokens, read only when the agent opens those files.

What are the alternatives to Building Gitops Workflows?

Skills that share tags, products or a category with Building Gitops Workflows: Implementing Gitops (ancoleman/ai-design-components, 526 stars), GitOps with ArgoCD and Flux (wshobson/agents, 40k stars), Argocd Gitops (BagelHole/DevOps-Security-Agent-Skills, 1.1k stars) and Argocd Gitops (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Building Gitops Workflows?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.