CtrlK
BlogDocsLog inGet started
Tessl Logo

k8s-yaml-validator

Comprehensive toolkit for validating, linting, testing Kubernetes YAML resources. Use this skill when validating Kubernetes manifests, debugging YAML syntax errors, performing dry-run tests on clusters, working with Custom Resource Definitions (CRDs) that require documentation lookup.

68

Quality

81%

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A highly actionable, well-sequenced validation workflow with exemplary load-triggered references and verified bundle files. The main weaknesses are redundancy — two overlapping anti-pattern sections re-explaining concepts Claude already knows — and detail inlined in SKILL.md that belongs in the reference files.

Suggestions

Merge the two anti-pattern sections ("Common Anti-Patterns" and "Anti-Patterns") into one, dropping the WHY explanations for behaviors Claude already knows (e.g. what client-side dry-run checks) and keeping only the BAD/GOOD command pairs.

Move the consolidated anti-patterns and the Error Handling Strategies section into references/validation_workflow.md, keeping SKILL.md to the staged workflow plus load triggers.

Make Stage 4's kubeconform command consistent with the 'never validate against the wrong Kubernetes version' anti-pattern by including -kubernetes-version in the canonical command or noting the server-side dry-run override inline.

DimensionReasoningScore

Conciseness

The workflow stages are command-dense and efficient, but the body is padded by two separate anti-pattern sections ("Common Anti-Patterns" and "Anti-Patterns") that overlap — e.g. client-vs-server dry-run appears in both — plus WHY explanations for concepts Claude already knows ("Client-side dry run only checks schema syntax locally; it does not contact the API server"). This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not the 4 anchor because the duplication is more than minor trimming.

3 / 5

Actionability

Every stage gives copy-paste-ready commands (yamllint with config path, the full kubeconform invocation with CRD catalog schema-location, kubectl dry-run variants), plus a concrete JSON output example and a report format template. This matches 'fully executable; copy-paste ready code or commands' covering the common cases.

5 / 5

Workflow Clarity

Stages 0–6 are clearly sequenced with fallback logic per stage and a "Verification After Fixes" section providing the validate→fix→re-validate feedback loop, matching 'clear sequence with most checkpoints present'. It is not 5 because of internal inconsistency: the anti-patterns mandate validating against the target cluster version, yet the Stage 4 kubeconform command omits -kubernetes-version, and the duplicated anti-pattern sections blur the canonical path.

4 / 5

Progressive Disclosure

References are one level deep, real files (references/validation_workflow.md and references/k8s_best_practices.md both exist), and explicitly load-triggered ("Load when the file contains 3+ resources..."), with scripts/ and assets/ catalogued. It stops short of 5 because ~200 lines of anti-pattern and error-handling detail are inlined in SKILL.md that would more appropriately live in the existing reference files.

4 / 5

Total

16

/

20

Passed

Description

87%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.

A strong description: third-person voice, concrete capability verbs, and an explicit 'Use this skill when...' clause with several natural trigger phrases. The only soft spot is keyword coverage that omits a few common synonyms and file extensions users might naturally say.

DimensionReasoningScore

Specificity

"validating, linting, testing Kubernetes YAML resources" names the domain and lists several specific concrete actions, matching the 'several specific actions; minor gaps in coverage' anchor. It falls short of 5 because 'testing' is generic compared to the comprehensive multi-action coverage of the 5 anchor, and no synonyms or variations of the actions are enumerated.

4 / 5

Completeness

It explicitly answers both: what ("Comprehensive toolkit for validating, linting, testing Kubernetes YAML resources") and when ("Use this skill when validating Kubernetes manifests, debugging YAML syntax errors, performing dry-run tests...") with multiple concrete trigger phrases. This matches the 5 anchor exactly; the 4 anchor applies only when the 'when' clause is less explicit, which is not the case here.

5 / 5

Trigger Term Quality

Natural phrases users would say are present: "validating Kubernetes manifests", "debugging YAML syntax errors", "performing dry-run tests on clusters", "Custom Resource Definitions (CRDs)". A few common variations are missing (e.g. '.yaml/.yml' extensions, 'kubectl apply failures'), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

"Kubernetes YAML resources" with CRD-specific and dry-run-specific triggers carves out a clear niche with minimal conflict risk against generic YAML or broader Kubernetes-deployment skills. The 4 anchor ('minor overlap risk with closely related skills') would apply if triggers like 'CRDs that require documentation lookup' did not so sharply scope the skill.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.