CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kubernetes

Cluster baseline scaffolding, RBAC diagnosis and generation, workload hardening, and structured pod/scheduling debug for plain Kubernetes across all distributions.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/platform-skills/skills/kubernetes/SKILL.md

The canonical home for this skill is kubernetes in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong operational skill body: concrete, executable manifests and commands with explicit validation and rollback loops in every mode. The weaknesses are redundancy between the wizard, activation, handoff, and common-mistakes sections, and a progressive-disclosure structure that inlines bulky templates while pointing at reference/example files that are not present in the bundle.

Suggestions

Ship the referenced files or drop the references: `references/kubernetes.md` is cited in every mode and `examples/kubernetes/*.yaml` in the Reference section, but neither exists in the bundle — either include them or remove the pointers.

Move the full YAML templates (baseline manifest set, hardened Deployment, HPA) into the examples/ files and keep only one compact exemplar inline, cutting SKILL.md's bulk substantially.

Deduplicate: the Interactive Wizard repeats the Activation menu, the Reference section repeats handoffs already made inline, and Common mistakes restates the CPU-limit, default-SA, startupProbe, and ClusterRoleBinding points from earlier sections — collapse these to one location each.

DimensionReasoningScore

Conciseness

The body is dominated by executable YAML and kubectl commands with terse, purposeful comments and almost no explanation of concepts Claude already knows — efficient per the score-4 anchor. It is not a 5 because of redundancy: the Interactive Wizard menu duplicates the Activation block, the closing Reference section repeats handoffs already made inline, and "Common mistakes" restates four points already made in the workload/RBAC sections.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: complete YAML manifests (Namespace, ResourceQuota, NetworkPolicy, PDB, Role/RoleBinding, hardened Deployment, HPA), runnable kubectl/jq pipelines, and commands with expected outputs ("# expected: yes"). Symptom→cause→fix tables cover the common debug cases exactly as the score-5 anchor describes.

5 / 5

Workflow Clarity

Each mode is a clearly sequenced multi-step process with explicit validation checkpoints and recovery loops: rbac runs diagnose → simulate (`kubectl auth can-i`) → find bindings → generate → validate with expected outputs plus rollback; debug runs collect evidence → classify by symptom (with a cause/fix decision table) → validate (rollout status) → rollback; baseline requires `--dry-run=server` before apply. This matches the top anchor's explicit validation, error-recovery branches, and checklists.

5 / 5

Progressive Disclosure

Section structure is good and references are clearly signaled ("Read `references/kubernetes.md`" per mode, one level deep), but the referenced bundle files do not exist — there is no `references/` or `examples/` directory — so the navigation targets are unverifiable/dangling. Additionally, ~400 lines of full YAML templates are inlined that belong in the referenced `examples/` files, matching the score-3 anchor of content that should be separate being inline. It is above a 2 because sections, signals, and handoffs are well organized.

3 / 5

Total

17

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and appropriately scoped to plain Kubernetes with four clearly named capability areas and good natural keyword coverage. Its main weakness is the complete absence of a "Use when..." clause or equivalent trigger guidance, which caps completeness; adding symptom-level trigger terms (crashloop, 403, ImagePullBackOff) would strengthen both completeness and trigger quality.

Suggestions

Append an explicit trigger clause, e.g., "Use when the user mentions Kubernetes, kubectl, namespaces, RBAC/403 errors, crashloops, OOMKilled, pending pods, or image pull errors."

Add symptom-level natural phrases users actually type — "crashloop", "OOMKilled", "403/forbidden", "ImagePullBackOff", "kubectl" — to the keyword set.

Convert the noun-phrase capability list into concrete third-person verbs (e.g., "Generates namespace baselines...", "Diagnoses 401/403 errors and generates minimal Roles") to sharpen specificity.

DimensionReasoningScore

Specificity

The description names several concrete capability areas — "Cluster baseline scaffolding", "RBAC diagnosis and generation", "workload hardening", and "structured pod/scheduling debug" — which matches the anchor for several specific actions with minor gaps. It falls short of a 5 because the capabilities are listed as noun phrases without concrete verbs (e.g., "generate Role/RoleBinding", "diagnose crashloops"), leaving coverage less comprehensive than the top anchor.

4 / 5

Completeness

The "what" is clear (baseline scaffolding, RBAC diagnosis/generation, workload hardening, pod/scheduling debug), but there is no "Use when..." clause or equivalent explicit trigger guidance — "for plain Kubernetes across all distributions" is a scope qualifier, not usage guidance, so completeness is capped at 3 per the judging guidelines. It is not a 2 because the "what" is concrete and multi-part, and not a 4 because the "when" is entirely absent rather than merely implicit-but-stated.

3 / 5

Trigger Term Quality

Natural keywords a user would say are present: "Kubernetes", "cluster", "RBAC", "workload", "pod", "scheduling", "debug", "hardening", "baseline" — good coverage per the score-4 anchor. It is not a 5 because common symptom-level phrases users actually type when they need this skill are missing (e.g., "crashloop", "OOMKilled", "403", "forbidden", "ImagePullBackOff", "kubectl").

4 / 5

Distinctiveness Conflict Risk

The scope "for plain Kubernetes across all distributions" carves out a clear niche distinct from provider-specific (EKS/GKE/AKS) or adjacent tooling skills (kyverno, keda, karpenter), giving mostly distinct coverage with minor overlap risk — matching the score-4 anchor. It is not a 5 because the description itself lacks distinct trigger phrases that would fully separate it from generic kubectl-troubleshooting skills, and it does not quite reach a 3 since the domain and scope are unmistakable.

4 / 5

Total

15

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (526 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

13

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/kubernetes/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.