CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/k8s-yaml-validator

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

Overall
score

93%

Does it follow best practices?

Validation for skill structure

Overview
Skills
Evals
Files

Discovery

100%

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

This is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, uses natural trigger terms that Kubernetes users would actually say, includes an explicit 'Use this skill when...' clause with multiple scenarios, and carves out a clear niche that distinguishes it from general YAML or document processing skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'validating, linting, and testing Kubernetes YAML resources', 'debugging YAML syntax errors', 'performing dry-run tests on clusters', 'working with Custom Resource Definitions (CRDs)'. These are concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('validating, linting, and testing Kubernetes YAML resources') and when ('Use this skill when validating Kubernetes manifests, debugging YAML syntax errors, performing dry-run tests on clusters, or working with Custom Resource Definitions'). Has explicit 'Use this skill when...' clause with multiple trigger scenarios.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'Kubernetes', 'YAML', 'validating', 'linting', 'manifests', 'syntax errors', 'dry-run', 'CRDs', 'Custom Resource Definitions'. These are terms users naturally use when working with Kubernetes configurations.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused specifically on Kubernetes YAML validation and testing. The combination of 'Kubernetes', 'manifests', 'CRDs', and 'dry-run tests' creates a distinct domain that wouldn't conflict with general YAML or document processing skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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, well-structured skill with excellent workflow clarity and actionability. The sequential validation stages with explicit fallback logic and error handling demonstrate thoughtful design. Minor verbosity in explanatory sections prevents a perfect conciseness score, but the content is highly functional and production-ready.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundant explanations (e.g., explaining what each stage catches, verbose descriptions of fallback logic). The JSON examples and workflow descriptions could be tightened while preserving clarity.

2 / 3

Actionability

Provides fully executable bash commands, specific tool configurations, concrete JSON output examples, and copy-paste ready code blocks. The kubeconform command with schema locations and the MCP tool usage are immediately actionable.

3 / 3

Workflow Clarity

Excellent sequential workflow with numbered stages (0-6), explicit validation checkpoints, clear fallback logic for each failure mode, and a structured error handling section. The partial parsing table and 'continue to next stage' guidance provide proper feedback loops.

3 / 3

Progressive Disclosure

Well-organized with clear overview, conditional loading of reference files (k8s_best_practices.md, validation_workflow.md), and a clean Resources section with one-level-deep references. The 'Load when...' triggers are clearly signaled.

3 / 3

Total

11

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Install with Tessl CLI

npx tessl i pantheon-ai/k8s-yaml-validator

Reviewed

Table of Contents