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
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/glab-cluster/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/glab-cluster/
1Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a codex2Manually: put the files in place
.agents/skills/glab-cluster/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a cursor2Manually: put the files in place
.cursor/skills/glab-cluster/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vince-winkintel/gitlab-cli-skills glab-cluster2Manually: put the files in place
.github/skills/glab-cluster/SKILL.md1Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a gemini-cli2Platform CLI
gemini skills install https://github.com/vince-winkintel/gitlab-cli-skills --path glab-clusterManually: put the files in place
.devin/skills/glab-cluster/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-cluster -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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