mk8s-byok

mk8s-byok is a skill for Claude Code, Codex from controlplane-com/ai-plugin. It costs 56 tokens per session (4,563 once invoked), scanned A, original, MIT.

A guide to running workloads on your own servers and managing Kubernetes clusters through Control Plane. Kubernetes is software for scheduling and operating containers; BYOK means bringing your own Kubernetes cluster.

In plain words
What is it for?
Use it for bare-metal or on-premises deployments, managed mk8s clusters, registering existing clusters, configuring node pools, and connecting BYOK locations.
Why use it?
It clarifies the difference between a cluster provisioned for you, a cluster you already manage, and Control Plane workloads scheduled onto that hardware.

Skill for Claude CodeCodex

Part of the cpln plugin — 30 skills, 2 commands, 2 agents, 1 hook, 1 MCP server shipped together

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/controlplane-com/ai-plugin/mk8s-byok
Any agent
npx skills add controlplane-com/ai-plugin --skill mk8s-byok
Clone the repo
git clone --depth 1 https://github.com/controlplane-com/ai-plugin

Made for: Claude Code, Codex.

Or install cpln, the plugin that ships this one along with the rest of its 30 skills, 2 commands, 2 agents, 1 hook, 1 MCP server.

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 mk8s-byok

README.md
[![agentmods](https://agentmods.dev/badge/skills/controlplane-com/ai-plugin/mk8s-byok.svg)](https://agentmods.dev/skills/controlplane-com/ai-plugin/mk8s-byok)
Your own site
<a href="https://agentmods.dev/skills/controlplane-com/ai-plugin/mk8s-byok"><img src="https://agentmods.dev/badge/skills/controlplane-com/ai-plugin/mk8s-byok.svg" alt="Measured on agentmods" height="20"></a>
Per session 56 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,563 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.00056 $0.04563
Opus 5 $0.00028 $0.02282
Sonnet 5 $0.00011 $0.00913
Haiku 4.5 $0.00006 $0.00456

Measured 5d ago against content hash 3ce68ba70932, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

mk8s-byok 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 5d ago.

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.

plugins/cpln/skills/mk8s-byok/SKILL.md · 180 lines

How it starts

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

Managed Kubernetes (mk8s) & BYOK

Tool availability: the create_mk8s_* / update_mk8s_* tools live in the mk8s toolset profile (?toolsets=mk8s; full includes it). If an mk8s tool is not advertised, tell the user to reconnect with ?toolsets=mk8s. Provider credential secrets (opaque token, gcp, keypair) must already exist — created by the user; offer to draft the manifest for them to fill and apply (setup-secret skill). Reads work on every profile via list_resources / get_resource (kind mk8s or location); delete_resource is on every profile except readonly.

Control Plane has three separate "Kubernetes" stories people routinely conflate — get the right one first:

  • mk8s — Control Plane provisions and manages a real, conformant Kubernetes cluster on your cloud account (12 providers). You get a kubeconfig and run normal Kubernetes. It is a standalone cluster — to schedule Control Plane (GVC) workloads onto it, add the byok add-on (below). Resource kind mk8s.
  • BYOK location — you already have a self-managed cluster; you register it as a Control Plane location so Control Plane workloads (GVC workloads) schedule onto it. Resource kind location, provider byok.
  • mk8s BYOK add-onaddOns.byok makes an mk8s cluster register itself as a Control Plane location: it links a location you create and installs the agent automatically (no manual cpln location install). This is how Control Plane workloads run on an mk8s cluster.

(If the user instead wants to manage Control Plane resources from kubectl, that is the k8s-operator skill, not this one.) The dominant failures: reaching for a nonexistent cpln mk8s create; skipping the per-provider credential secret; and leaving the cluster's API-server firewall wide open.

"Can I run this on my own servers?" — yes

Bare metal in a data center or colo, on-prem VMs (VMware/vSphere), a Dell or Supermicro rack — any Linux server becomes a Control Plane location the user deploys to exactly like aws-us-east-1. "BYOC" means the same thing with the cluster in their own cloud account. Never answer this question with cloud regions only. Two routes, picked by what they already have:

Read the full file on GitHub · 180 lines

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. 5d ago First seen · 180 lines · 56 tokens per session scan A 3ce68ba70932

Subscribe to this mod's changes

mk8s-byok is a skill published in the GitHub repository controlplane-com/ai-plugin (10 stars, last pushed 11d ago), licensed MIT. It adds 56 tokens to every session and 4,563 once invoked, about $0.0003 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-08-31.

Related

Other skills, from other repositories

nginx-to-higress-migration

Migrate from ingress-nginx to Higress in Kubernetes environments. Use when (1) analyzing existing ingress-nginx setup (2) reading nginx Ingress resources and ConfigMaps (3) installing Higress via helm with proper ingressClass (4) identifying unsupported nginx annotations (5) generating WASM plugins for nginx…

higress-group/higress · 99 tokens

ak-cloud-deploy

Deploy an Agent Kernel project to AWS, Azure, or GCP using Terraform modules, or to any Kubernetes cluster (on-prem, baremetal, EKS) using the official Helm chart. Supports serverless and containerized modes for all three clouds. AWS supports execution modes (restsync, restasync, async, stream), queue-based scalable…

yaalalabs/agent-kernel · 146 tokens

openpitrix

KubeSphere OpenPitrix application management Skill. Use when users ask about KubeSphere App Store, OpenPitrix, Helm/YAML application templates, application repositories, app versions, app releases, categories, review states, repository sync, or troubleshooting application installation and upgrade issues.

kubesphere/kubesphere · 60 tokens

kubesphere-volcano

KubeSphere Volcano job management Skill. Use when user asks to create, list, update, delete Jobs (Volcano Jobs), manage Queues, create PyTorch/TensorFlow/MPI training jobs, or troubleshoot Volcano scheduling issues in KubeSphere. Includes built-in YAML templates, scheduling policy recommendations, and best practices…

kubesphere/kubesphere · 85 tokens

kubesphere-openkruise

KubeSphere OpenKruise management Skill. Use when user asks to install or enable OpenKruise, check OpenKruise status, view kruise pods/logs/CRDs, create or update SidecarSet, manage sidecar injection, create or update CloneSet, perform in-place update or batch rollout, uninstall or remove OpenKruise, or troubleshoot…

kubesphere/kubesphere · 99 tokens

together-kueue

Install and use the Kueue job-queueing controller on a Together AI Kubernetes GPU cluster to gate jobs on quota. Covers installing Kueue, defining ResourceFlavor, ClusterQueue, and LocalQueue quota, submitting jobs to a queue, and watching quota admit or suspend them. Reach for it when a Together cluster's GPU pool…

togethercomputer/skills · 124 tokens