Skip to content
cccskills
FreePublished on GitHub

k8s-vind

Manage vCluster (virtual Kubernetes clusters) instances using vind. Use when creating, managing, or operating lightweight virtual clusters for development, testing, or multi-tenancy.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (2)

  • SKILL.md5.3 KB
  • references/WORKFLOWS.md3.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

vCluster (vind) Management

Manage virtual Kubernetes clusters using kubectl-mcp-server's vind tools (14 tools).

Requires the vind toolset: start kubectl-mcp-server with --toolsets default,vind (or MCP_TOOLSETS=default,vind).

vCluster enables running fully functional Kubernetes clusters as lightweight workloads inside a host cluster, combining multi-tenancy with strong isolation.

When to Apply

Use this skill when:

  • User mentions: "vCluster", "vind", "virtual cluster", "lightweight cluster"
  • Operations: creating dev environments, multi-tenant isolation, ephemeral clusters
  • Keywords: "virtual Kubernetes", "dev cluster", "pause cluster", "tenant isolation"

Priority Rules

PriorityRuleImpactTools
1Detect vCluster CLI firstCRITICALdetect_ecosystem
2Check cluster status before operationsHIGHvind_status
3Connect before kubectl operationsHIGHvind_connect
4Pause unused clusters to save resourcesMEDIUMvind_pause

Quick Reference

TaskToolExample
Detect vClusterdetect_ecosystemdetect_ecosystem()
List clustersvind_list_clustersvind_list_clusters()
Create clustervind_create_clustervind_create_cluster(name)
Connect to clustervind_connectvind_connect(name)

Prerequisites

  • vCluster CLI: Required for all vind tools
    curl -L -o vcluster "https://github.com/loft-sh/vcluster/releases/latest/download/vcluster-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"
    chmod +x vcluster && sudo mv vcluster /usr/local/bin/
    

Check Installation

detect_ecosystem()

List Clusters

vind_list_clusters()

Get Cluster Status

vind_status(name="my-vcluster", namespace="vcluster")

Get Kubeconfig

vind_get_kubeconfig(name="my-vcluster", namespace="vcluster")

Status

vind_status(name="my-vcluster", namespace="vcluster")

Cluster Lifecycle

Create Cluster

vind_create_cluster(name="dev-cluster")

vind_create_cluster(
    name="dev-cluster",
    namespace="dev",
    kubernetes_version="v1.29.0",
    connect=True
)

vind_create_cluster(
    name="custom-cluster",
    set_values="sync.toHost.pods.enabled=true,sync.toHost.services.enabled=true"
)

Delete Cluster

vind_delete_cluster(name="dev-cluster")

vind_delete_cluster(
    name="dev-cluster",
    namespace="dev",
    delete_namespace=True
)

Pause Cluster (Save Resources)

vind_pause(name="dev-cluster")

Resume Cluster

vind_resume(name="dev-cluster")

Connect/Disconnect

Connect to Cluster

vind_connect(name="dev-cluster")

vind_connect(
    name="dev-cluster",
    namespace="dev",
    kube_config="~/.kube/vcluster-config"
)

Disconnect from Cluster

vind_disconnect()

Upgrade Cluster

vind_upgrade(
    name="dev-cluster",
    kubernetes_version="v1.30.0"
)

vind_upgrade(
    name="dev-cluster",
    values_file="new-values.yaml"
)

Describe Cluster

vind_describe(name="dev-cluster")

Development Workflow

Quick Dev Environment

vind_create_cluster(name="dev", connect=True)

kubectl_apply(manifest="""
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: app
        image: nginx:alpine
""")

Multi-Tenant Setup

vind_create_cluster(name="team-a", namespace="team-a-vcluster")
vind_create_cluster(name="team-b", namespace="team-b-vcluster")

vind_list_clusters()

Resource Management

vind_pause(name="dev")

vind_resume(name="dev")

Docker-Specific Configuration

For vCluster in Docker (vind) deployments, use --set values:

vind_create_cluster(
    name="docker-cluster",
    set_values="experimental.docker.network=my-network,experimental.docker.ports[0].containerPort=80"
)

Troubleshooting

Cluster Not Starting

1. detect_ecosystem()
2. vind_status(name="my-cluster")
3. vind_describe(name="my-cluster")

Connection Issues

1. vind_disconnect()
2. vind_connect(name="my-cluster")
3. vind_get_kubeconfig(name="my-cluster")

Resource Issues

1. vind_pause(name="unused-cluster")
2. vind_delete_cluster(name="old-cluster", delete_namespace=True)

CLI Installation

Install vCluster CLI:

curl -L -o vcluster "https://github.com/loft-sh/vcluster/releases/latest/download/vcluster-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)"
chmod +x vcluster
sudo mv vcluster /usr/local/bin/

vcluster version

Related Skills

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Configure Kubernetes autoscaling with HPA, VPA, and KEDA. Use for horizontal/vertical pod autoscaling, event-driven scaling, and capacity management.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

Kubernetes backup and restore with Velero. Use when creating backups, restoring applications, managing disaster recovery, or migrating workloads between clusters.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

Cluster API lifecycle management for provisioning, scaling, and upgrading Kubernetes clusters. Use when managing cluster infrastructure or multi-cluster operations.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

Kubernetes certificate management with cert-manager. Use when managing TLS certificates, configuring issuers, or troubleshooting certificate issues.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

Cilium and Hubble network observability for Kubernetes. Use when managing network policies, observing traffic flows, or troubleshooting connectivity with eBPF-based networking.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

kubectl-mcp-server CLI commands for tool discovery, direct invocation, and diagnostics. Use when exploring available tools, calling tools from command line, or checking server health.

The English summary is being prepared. Showing the original description.

rohitg00/kubectl-mcp-server964Updated Oct 23, 2026

See all skills by rohitg00

Report a problem with this skill