k8s-local

k8s-local is a skill for Claude Code, Codex from fmind/dot. It costs 44 tokens per session (1,227 once invoked), scanned A, original, MIT.

A guide for running a small Kubernetes cluster locally with k3d or kind. Kubernetes is software for deploying and managing containerized applications.

In plain words
What is it for?
Use it to start and stop a local cluster and deploy applications with kubectl, Helm, Helmfile, or Skaffold.
Why use it?
It provides an isolated workstation environment for testing Kubernetes deployments without using a shared or production cluster.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fmind/dot/k8s-local
Any agent
npx skills add fmind/dot --skill k8s-local
Clone the repo
git clone --depth 1 https://github.com/fmind/dot

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for k8s-local

README.md
[![agentmods](https://agentmods.dev/badge/skills/fmind/dot/k8s-local.svg)](https://agentmods.dev/skills/fmind/dot/k8s-local)
Your own site
<a href="https://agentmods.dev/skills/fmind/dot/k8s-local"><img src="https://agentmods.dev/badge/skills/fmind/dot/k8s-local.svg" alt="Measured on agentmods" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,227 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00044 $0.01227
Opus 5 $0.00022 $0.00613
Sonnet 5 $0.00009 $0.00245
Haiku 4.5 $0.00004 $0.00123

Measured yesterday against content hash b70e98a74361, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

k8s-local scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/k8s-local/SKILL.md · 60 lines

How it starts

The opening of the file, as written. The whole thing — 60 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Local Kubernetes

Run an opt-in k3d (default) or kind cluster on the workstation and deploy into it declaratively. cloud-run is the default deploy target, so the Kubernetes tools are commented out in the global mise config: uncomment them or pin them in the project mise.toml first.

Workflow

  1. Choose the scope: quick experiments use the global dot cluster from dot-cli; a real project stays self-contained (see the project-scope gotcha).

  2. Check Docker: run docker info before starting, stopping, or configuring a cluster.

  3. Start the cluster, OFF by Default: run it only for a short verification window and stop it as soon as the task ends; k3d containers use restart=unless-stopped, so they return after a reboot until stopped.

    dot cluster start   # k3d from ~/.config/k3d/local.yaml: idempotent, owner-only kubeconfig, never touches the default context
    kind create cluster --config ~/.agents/skills/k8s-local/references/kind-config.yaml
    
  4. Target the isolated context: never switch the default kubeconfig; a renamed context needs dot cluster --context <name> <command>.

    kubectl --kubeconfig ~/.kube/dot/local.yaml --context k3d-local get nodes
    dot cluster namespace <namespace>
    
  5. Validate manifests: kubeconform -strict <path> for schema, kube-linter lint <path> for practices and security.

  6. Publish images: push to the local registry or sideload, always with a specific tag and imagePullPolicy: IfNotPresent or Never in the manifest.

    docker tag <image>:<tag> registry.localhost:5050/<image>:<tag> && docker push registry.localhost:5050/<image>:<tag>
    k3d image load <image>:<tag> -c local                        # k3d sideload
    kind load docker-image <image>:<tag> --name local-cluster    # kind sideload
    
  7. Deploy declaratively: helm upgrade --install <release> <chart> -n <namespace> --create-namespace, helmfile apply, skaffold dev, or kubectl apply -k <dir>; expose with ingress-template.yaml.

  8. Diagnose with bounded evidence: dot cluster diagnose --namespace <namespace> verifies the isolated target, runs only the read-only allowlist, redacts secrets, and writes an owner-only manifest; review it locally before sharing.

  9. Stop or delete: dot cluster stop is the resting state; dot cluster delete is destructive and asks for confirmation; kind delete cluster --name local-cluster removes the kind cluster.

Read the full file on GitHub · 60 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 60 lines · 44 tokens per session scan A b70e98a74361

Subscribe to this mod's changes

k8s-local is a skill published in the GitHub repository fmind/dot (4 stars, last pushed yesterday), licensed MIT. It adds 44 tokens to every session and 1,227 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.