# Kubesphere Cluster Management

KubeSphere cluster query Skill (read-only).

- Repository: https://github.com/kubesphere/kubesphere (17074 stars)
- Category: Writing
- License: see repository
- Last updated: 2026-07-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kubesphere/kubesphere --skill kubesphere-cluster-management -g -a claude-code -y`
Codex: `npx skills add kubesphere/kubesphere --skill kubesphere-cluster-management -g -a codex -y`
Cursor: `npx skills add kubesphere/kubesphere --skill kubesphere-cluster-management -g -a cursor -y`
Gemini CLI: `npx skills add kubesphere/kubesphere --skill kubesphere-cluster-management -g -a gemini-cli -y`

## Description

KubeSphere cluster query Skill (read-only). Use when user requests to view cluster list, cluster status, cluster details, or cluster version info. Do not perform any write operations (create, delete, update). Use KubeSphere Console for management operations.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# KubeSphere Cluster Query

> **⚠️ Security**: Read-only only. **Never** use kubectl to create, update, or delete cluster resources. Use KubeSphere console instead.

## When to Use

List or get KubeSphere cluster information: list clusters, get details, check status, identify host/member.

## Commands

```bash
# List clusters
kubectl get cluster

# Get cluster details
kubectl get cluster <name> -o yaml

# Get cluster summary (name, connection type, version, status)
kubectl get cluster -o go-template='
{{printf "%-12s %-12s %-12s %-15s %-13s %-12s\n" "NAME" "CONN_TYPE" "KS_VERSION" "K8S_VERSION" "ClusterReady" "KSCORE_READY"}}
{{range .items}}{{printf "%-12s %-12s %-12s %-15s" .metadata.name .spec.connection.type .status.kubeSphereVersion .status.kubernetesVersion}}{{range .status.conditions}}{{if eq .type "Ready"}}{{printf "%-13s" .status}}{{end}}{{end}}{{range .status.conditions}}{{if eq .type "KSCoreReady"}}{{printf "%-12s" .status}}{{end}}{{end}}{{"\n"}}{{end}}'
```

## Out of Scope

Cluster installation/upgrade/remove, any write operations. Use KubeSphere console.