Skip to main content
skill CX Codex

glab-cluster — Claude Code skill for GitLab clusters

The glab-cluster Claude Code skill manages GitLab Kubernetes clusters and their agents. It activates for cluster connections and Kubernetes integration tasks.

MIT 113 installs ★ 51 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a claude-code
Open on GitHub

What glab-cluster does

The skill uses glab cluster commands to manage GitLab Agents for Kubernetes. It can list agents and their tokens, and query a Kubernetes object graph through an agent. The graph command is experimental.

Agent and token lists support JSON output for automation. Agent results are paginated: set --page and --per-page to move through them, since the JSON response contains only the requested page.

On Snap, kubeconfig access is scoped to ~/.kube/config and ~/.kube/config.lock. Connecting that access or changing kubeconfig alters local permissions or configuration and requires approval; CLI help alone does not authorize changes to a cluster.

What it helps with

  • connect a Kubernetes cluster to GitLab
  • manage GitLab Agents for Kubernetes
  • export agent or token lists as JSON
  • query Kubernetes objects through a GitLab agent

Example prompts for the agent

  • Connect this Kubernetes cluster to GitLab and show how to manage its agent.
  • List the GitLab Kubernetes agents as JSON.
  • Query the Kubernetes object graph through the GitLab agent.

How to install glab-cluster

1Skills CLI (Vercel)

npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a claude-code

2Manually: put the files in place

~/.claude/skills/glab-cluster/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/glab-cluster/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about glab-cluster

How do I install glab-cluster in Claude Code?

Run npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a claude-code. The skill file is at ~/.claude/skills/glab-cluster/SKILL.md.

What does glab-cluster do?

It manages GitLab Agents for Kubernetes, lists agents and tokens, and queries a cluster’s object graph through an agent.

How do I retrieve every page of agents as JSON?

Set --page and --per-page explicitly. Each JSON response covers the requested page, so its length does not show whether more results exist.

Source text

SKILL.md · MIT
---
name: glab-cluster
description: Manage GitLab Kubernetes clusters and agent integrations. Use when connecting clusters, managing cluster agents, or working with Kubernetes integration. Triggers on cluster, Kubernetes, k8s, cluster agent, connect cluster.
---

# glab cluster

> Capture key `4dd0d32d1`: checksum-verified official macOS arm64 binary, source commit `4dd0d32d18361db6c1c668eb4ac691c0d6edf255`, archive SHA-256 `11980310aaad2bd9c4e75b5635a60e984da5d0e6245187f2cd6e8db0ec4c5a92`. Only adjacent marked help fences use this provenance; complete renderer output is preserved except trailing spaces/tabs. Other fences retain their stated prior provenance.

## Overview

<!-- help-capture: 4dd0d32d1:ed5b0c665871 -->

```text

  Agents connect your cluster to GitLab, enabling pull-based deployments
  and secure access to the Kubernetes API.


  USAGE

    glab cluster <command> [command] [--flags]

  COMMANDS

    agent <command> [command] [--flags]  Manage GitLab Agents for Kubernetes.
    graph [--flags]                      Query the Kubernetes object graph using the GitLab Agent for Kubernetes. (EXPERIMENTAL)

  FLAGS

    -h --help                            Show help for this command.
    -R --repo                            Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

```

## Quick start

```bash
glab cluster --help
```

## Structured output

`glab cluster agent list` and `glab cluster agent token list` support `--output json` / `-F json` for structured output, which is useful for agent automation.

```bash
# List cluster agents with JSON output
glab cluster agent list --output json
glab cluster agent list -F json

# List agent tokens with JSON output
glab cluster agent token list <agent-id> --output json
glab cluster agent token list <agent-id> -F json
```

`glab cluster agent list` uses the API-reported total in its text header when available, separately from the current page's row count. JSON remains the requested page of agents. Traverse `--page` / `--per-page` explicitly; neither a page's JSON length nor missing total metadata proves there are no further results. This total change applies to the agent list, not the agent-token list.

## Subcommands

See [references/commands.md](references/commands.md) for full `--help` output.

## Snap kubeconfig access

The snap uses the manual-connect `dot-kube-config` plug, scoped to `~/.kube/config` and `~/.kube/config.lock`, rather than the whole `.kube` directory. A different kubeconfig path can remain inaccessible under confinement. Connecting the plug or updating kubeconfig changes local permissions/configuration and requires approval; do not treat CLI help as permission to connect it or modify a cluster.

© vince-winkintel · MIT · vince-winkintel/gitlab-cli-skills

Similar skills

All skills for DevOps and infrastructure →

From the same set45

The whole set →
glab-snippet The glab-snippet Claude Code skill creates GitLab snippets from files or stdin text. It activates when a request is to share code or text as a new snippet. CX Codex +1 115installs glab-todo The glab-todo Claude Code skill manages GitLab to-dos through the CLI. It lists assigned or mentioned work and marks selected items as done. CX Codex +1 115installs glab-milestone The glab-milestone Claude Code skill manages GitLab milestones, from creating and editing them to listing, viewing, and deleting them. It activates for release planning and milestone progress tasks. CX Codex +1 114installs glab-iteration glab-iteration — a skill for Claude Code and Codex that manages GitLab iterations. It activates for sprint planning, issue assignment, and progress checks. CX Codex +1 114installs glab-runner-controller The glab-runner-controller Claude Code skill manages GitLab Runner controllers and their tokens. It activates for requests about controller setup, scopes, or token changes. CX Codex +1 113installs glab-attestation The glab-attestation Claude Code skill works with GitLab attestations and checks software artifact provenance. It activates for requests about artifact verification or supply chain security. CX Codex +1 113installs glab-whatsnew This Claude Code skill displays GitLab CLI release notes through glab whatsnew. It activates for questions about new releases, changes after an upgrade, or notes from a chosen version. CX Codex +1 112installs glab-securefile The glab-securefile Claude Code skill manages GitLab secure files used by CI/CD pipelines. It activates for tasks involving pipeline secrets, certificates, or protected configuration files. CX Codex +1 112installs

Project sponsors

Companies that keep this analytics open