kindctl

name	kindctl
description	Use repo/worktree-scoped kind clusters without touching the global kubeconfig. Trigger when users mention kind cluster, local k8s, local Kubernetes, spin up a cluster, Kubernetes-in-Docker, multi-repo kind, or multi-worktree cluster work.

kindctl

Use this skill whenever work involves a local kind cluster, local k8s/Kubernetes, Kubernetes-in-Docker, or repo/worktree-specific test clusters.

Mental model

• kind clusters are global to the Docker daemon.
• ~/.kube/config is a shared mutable global and must not be used for kindctl-managed clusters.
• kindctl derives a cluster name from the current repo/worktree path and stores its kubeconfig in ~/.kube/kind/<name>.kubeconfig.
• The current directory is enough: random repos and git worktrees do not need to know anything special.

Golden rule for agents

Never run bare kubectl or helm against a kindctl-managed cluster.

Prefer:

$HOME/.agents/skills/kindctl/scripts/kindctl kubectl get nodes
$HOME/.agents/skills/kindctl/scripts/kindctl exec -- helm list

Do not run:

kubectl get pods
kubectl config use-context kind-something
kind create cluster

Installation

Install from the skills collection:

npx skills@latest add sozercan/skills --skill kindctl -y

The skill itself should invoke scripts/kindctl by absolute path or by resolving the installed skill directory. Do not rely on shell aliases.

Commands