Agent skill

KubeSphere DevOps ArgoCD Setup

by kubesphere in kubesphere/kubesphere

Guides GitOps deployments with the ArgoCD bundled in KubeSphere DevOps: applications, Dex SSO, repository credentials and sync troubleshooting.

Custom licenceAuto-check: notesDevOps & Cloud

Install KubeSphere DevOps ArgoCD Setup

skills CLI
$ npx skills add kubesphere/kubesphere --skill kubesphere-devops-argocd -a claude-code

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

GitHub CLI
$ gh skill install kubesphere/kubesphere kubesphere-devops-argocd --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/kubesphere/kubesphere.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kubesphere-devops-argocd .claude/skills/kubesphere-devops-argocd && 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
kubesphere-devops-argocd
GitHub stars
17k
Token cost
~5.8k tokens
SKILL.md length
886 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
Custom licence

At a glance

Guides GitOps deployments with the ArgoCD bundled in KubeSphere DevOps: applications, Dex SSO, repository credentials and sync troubleshooting.

  • Works in 4 steps: Tenant creates Application… → KubeSphere automatically adds label:… → KubeSphere controller creates… → …
  • Setting up GitOps continuous deployment on KubeSphere DevOps
  • SKILL.md covers Overview, When to Use, KubeSphere GitOps Integration and Architecture, plus 7 more sections
  • Calls kubectl, argocd and curl; reaches github.com and kubernetes.default.svc; needs API_TOKEN and ARGO_TOKEN

What it does

KubeSphere DevOps ships ArgoCD v2.11.7 as a bundled subchart, and this skill gives the agent a map of how it fits into KubeSphere. It explains the two ways to create applications: a direct ArgoCD Application in the argocd namespace for administrators, and a KubeSphere GitOps application created through the gitops.kubesphere.io API in a tenant namespace, where KubeSphere creates the matching ArgoCD Application behind the scenes.

The skill also lists the ArgoCD components running in the cluster, including the application and ApplicationSet controllers, the Dex server, the notifications controller, Redis, the repo server and the API server, along with the pod name patterns to look for. Its use cases cover ApplicationSets, SSO through Dex, multi-cluster deployments, repository credentials and diagnosing sync problems.

When your agent uses it

  • Setting up GitOps continuous deployment on KubeSphere DevOps
  • Creating ArgoCD applications or ApplicationSets for a tenant namespace
  • Enabling SSO sign-in for ArgoCD through Dex
  • Diagnosing ArgoCD sync failures in a KubeSphere cluster

Example prompts

  • “Set up a GitOps application in the demo-project namespace that syncs from our Git repo.”
  • “Turn on Dex SSO for ArgoCD in our KubeSphere DevOps install.”
  • “Why is my ArgoCD application stuck out of sync after the last commit?”
  • “Add credentials so ArgoCD can pull from our private Git repository.”

Requirements

  • A KubeSphere installation with the DevOps extension
  • kubectl access to the cluster

Workflow steps

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

  1. Tenant creates Application (gitops.kubesphere.io/v1alpha1) in their namespace
  2. KubeSphere automatically adds label: gitops.kubesphere.io/argocd-location: argocd
  3. KubeSphere controller creates corresponding ArgoCD Application in argocd namespace
  4. ArgoCD syncs the application to the tenant's namespace

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • kubectl
    • argocd
    • curl
    • jq

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • kubernetes.default.svc
    • charts.helm.sh
    • argocd-server.argocd

    Also links to:

    • argo-cd.readthedocs.io
    • docs.kubesphere.io

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_TOKEN
    • ARGO_TOKEN

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

Context cost

KubeSphere DevOps ArgoCD Setup loads about 5.8k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 886 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~5.8k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:441
    sudo install -m 555 argocd-linux-amd64 /usr/local/bin/argocd

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); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 886 words (~5,832 tokens).

“KubeSphere DevOps includes ArgoCD v2.11.7 as a bundled subchart for GitOps continuous deployment. ArgoCD follows the declarative GitOps pattern, automatically syncing application state with Git repositories.”

— opening of SKILL.md by kubesphere, Custom licence
name
kubesphere-devops-argocd

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/kubesphere-devops-argocd of kubesphere/kubesphere.

Open the folder on GitHubat commit 04a29b5

Compare with similar skills

KubeSphere DevOps ArgoCD Setup 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.

KubeSphere DevOps ArgoCD Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
KubeSphere DevOps ArgoCD Setup this skillkubesphere/kubesphere17k—~5.8kAutomated safety check: NotesCustom licence
Kubernetes ArchitectCybereason-Public/owLSM2809 repos~2.6kAutomated safety check: PassGPL-2.0
Kubernetes SpecialistJeffallan/claude-skills12k1 repos~2.1kAutomated safety check: PassMIT
GitOps with ArgoCD and Fluxwshobson/agents40k12 repos~1.5kAutomated safety check: PassMIT
Signozqjoly/GitOps112—~6.1kAutomated safety check: PassWTFPL
Ksaildevantler-tech/ksail165—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Kubernetes Architect

    Cybereason-Public/owLSM

    Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration.

    280 GitHub starsUsed in 9 repos~2.6k tokens
    DevOps & CloudAuto-check passed
  • Kubernetes Specialist

    Jeffallan/claude-skills

    Creates and checks Kubernetes manifests, Helm charts, RBAC and network policies, and helps debug pod problems, with kubectl checks and rollback steps.

    12k GitHub starsUsed in 1 repo~2.1k tokens
    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
  • Signoz

    qjoly/GitOps

    Manage the self-hosted SigNoz observability stack in this GitOps repo.

    112 GitHub stars~6.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Ksail

    devantler-tech/ksail

    Use the ksail CLI to spin up and manage Kubernetes clusters (Kind/K3d/Talos/vCluster/KWOK — local via Docker; EKS — cloud via AWS) and GitOps workloads declaratively.

    165 GitHub stars~1.1k tokensUpdated today
    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

More from kubesphere/kubesphere

All 32 skills in this repo
  • Creates and queries KubeSphere users, workspaces and projects and assigns built-in roles, defaulting to least privilege and never deleting anything.

    17k GitHub starsUsed in 1 repo~3.1k tokens
    Auto-check passed
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • KubeEye Cluster Inspection

    kubesphere/kubesphere

    Deploys KubeEye on KubeSphere and writes InspectRule and InspectPlan resources to inspect cluster health, then retrieves the inspection reports.

    17k GitHub stars~3.6k tokensUpdated 2 mo ago
    Auto-check passed
  • KubeSphere NodeGroup Operations

    kubesphere/kubesphere

    Queries, creates, updates, binds and troubleshoots NodeGroup resources in the edgewize nodegroup project through a bundled authenticated API script.

    17k GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • WizTelemetry Platform Service

    kubesphere/kubesphere

    Installs and configures the WizTelemetry Platform Service extension for KubeSphere, the shared API server behind its observability extensions.

    17k GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Runs the lifecycle of FrontendExtension resources in a Kubernetes cluster: create, rebuild, package, publish, unpublish, delete and debug stuck states.

    17k GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about KubeSphere DevOps ArgoCD Setup

What does KubeSphere DevOps ArgoCD Setup do?

Guides GitOps deployments with the ArgoCD bundled in KubeSphere DevOps: applications, Dex SSO, repository credentials and sync troubleshooting. 7 as a bundled subchart, and this skill gives the agent a map of how it fits into KubeSphere.io API in a tenant namespace, where KubeSphere creates the matching ArgoCD Application behind the scenes.

When should I use KubeSphere DevOps ArgoCD Setup?

KubeSphere DevOps ArgoCD Setup fits situations like: setting up GitOps continuous deployment on KubeSphere DevOps; creating ArgoCD applications or ApplicationSets for a tenant namespace; enabling SSO sign-in for ArgoCD through Dex; diagnosing ArgoCD sync failures in a KubeSphere cluster.

How do I install KubeSphere DevOps ArgoCD Setup in Claude Code?

Run `npx skills add kubesphere/kubesphere --skill kubesphere-devops-argocd -a claude-code`. Or copy the skill folder (skills/kubesphere-devops-argocd in kubesphere/kubesphere) into .claude/skills/kubesphere-devops-argocd in your project. Claude Code loads it when a task matches its description.

How do I install KubeSphere DevOps ArgoCD Setup in Codex?

Run `npx skills add kubesphere/kubesphere --skill kubesphere-devops-argocd -a codex`. Or copy the skill folder (skills/kubesphere-devops-argocd in kubesphere/kubesphere) into .agents/skills/kubesphere-devops-argocd in your project. Codex loads it when a task matches its description.

Can I use KubeSphere DevOps ArgoCD Setup 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 kubesphere/kubesphere --skill kubesphere-devops-argocd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kubesphere-devops-argocd, .gemini/skills/kubesphere-devops-argocd, .github/skills/kubesphere-devops-argocd and .opencode/skills/kubesphere-devops-argocd in your project.

What does KubeSphere DevOps ArgoCD Setup need to run?

Going by SKILL.md and its folder, KubeSphere DevOps ArgoCD Setup needs the command-line tools its instructions call (kubectl, argocd, curl and jq) and credentials named API_TOKEN and ARGO_TOKEN. Our summary lists: A KubeSphere installation with the DevOps extension; kubectl access to the cluster.

Does KubeSphere DevOps ArgoCD Setup access the network?

SKILL.md names 6 domains. In commands or code: github.com, kubernetes.default.svc, charts.helm.sh and argocd-server.argocd; the agent is likely to contact these when it follows the instructions. As links in the text: argo-cd.readthedocs.io and docs.kubesphere.io. This is read from the text; nothing was executed.

Is KubeSphere DevOps ArgoCD Setup safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does KubeSphere DevOps ArgoCD Setup use?

KubeSphere DevOps ArgoCD Setup has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does KubeSphere DevOps ArgoCD Setup use?

About 5.8k tokens (SKILL.md is roughly 23k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to KubeSphere DevOps ArgoCD Setup?

Skills that share tags, products or a category with KubeSphere DevOps ArgoCD Setup: Kubernetes Architect (Cybereason-Public/owLSM, 280 stars), Kubernetes Specialist (Jeffallan/claude-skills, 12k stars), GitOps with ArgoCD and Flux (wshobson/agents, 40k stars) and Signoz (qjoly/GitOps, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains KubeSphere DevOps ArgoCD Setup?

kubesphere (a GitHub organization) maintains it in kubesphere/kubesphere, which has 17,060 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on July 15, 2026.

Source: kubesphere/kubesphere on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.