CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

87%

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

81%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 strong error-handling and fallback logic, appropriately split across references and scripts. Its main weakness is redundancy: duplicate anti-pattern sections and a redundant Overview inflate token cost without adding guidance.

Suggestions

Merge the 'Common Anti-Patterns' and 'Anti-Patterns' sections into one (they duplicate the same client-dry-run and schema-location advice), or move the consolidated section into a reference file loaded on demand.

Remove the 'Overview' section, which restates the frontmatter description, and replace it with a one-line pointer to the workflow stages.

Trim the 'Mindset' section's repeated justification of the layered funnel (the point is made twice in the first paragraph).

DimensionReasoningScore

Conciseness

Mostly efficient, concrete command-driven content, but there is real redundancy: two separate anti-pattern sections repeat the same advice (e.g., 'NEVER: Trust Client-Side Validation Alone' vs 'NEVER use only kubectl apply --dry-run=client'), and the Overview restates the frontmatter description. Fits anchor 3 ('could be tightened'); not 2 because the bulk is executable rather than padded, not 4 because the duplicated sections are unnecessary tokens.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance at every stage: exact yamllint, kubeconform (with full schema-location flags), kubectl dry-run, and script invocations, plus a sample JSON output and a concrete report/issue format. Matches anchor 5's 'copy-paste ready commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Stages 0-6 are clearly sequenced with explicit per-stage fallback logic (server dry-run falls back to client dry-run with documented limitation; secondary CRD detection when the wrapper fails) and a 'Verification After Fixes' re-validation loop. This matches anchor 5's 'explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

References are one level deep with explicit load conditions ('Load when schema validation fails with type errors', 'Load when the file contains 3+ resources') and all referenced bundle files exist. However, two long anti-pattern sections are inlined in the body where they belong in a reference file, a minor organization gap matching anchor 4 rather than 5.

4 / 5

Total

17

/

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 with an explicit third-person capability statement and a well-formed 'Use this skill when...' trigger clause covering concrete scenarios. Minor improvements possible by adding common synonyms users would say (e.g., .yaml, K8s, kubectl) and naming the report output.

DimensionReasoningScore

Specificity

The description lists several concrete actions ('validating, linting, testing Kubernetes YAML resources', 'debugging YAML syntax errors, performing dry-run tests on clusters') with minor gaps in coverage (e.g., schema validation and report generation are not mentioned). It matches anchor 4 rather than 5 because coverage is not fully comprehensive, and clearly exceeds anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

It explicitly answers both what ('validating, linting, testing Kubernetes YAML resources') and when ('Use this skill when validating Kubernetes manifests, debugging YAML syntax errors, performing dry-run tests on clusters, working with Custom Resource Definitions'), with concrete trigger phrases. This matches anchor 5 exactly; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Kubernetes manifests', 'YAML syntax errors', 'dry-run tests', 'Custom Resource Definitions (CRDs)'. A few natural terms users would say are missing (e.g., '.yaml' file extensions, 'K8s', 'kubectl apply'), so it fits anchor 4 rather than 5 but is well above anchor 3's 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The Kubernetes manifest validation niche is distinct, with triggers like 'dry-run tests on clusters' and 'CRDs that require documentation lookup' that are unlikely to fire for unrelated skills. Clear match to anchor 5's 'clear niche with distinct triggers'.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pantheon-org/tekhne

Path

skills/infrastructure/k8s/yaml-validator/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.