Validate documentation YAML examples against Kubernetes CRD schemas.
npx skills add https://github.com/stacklok/docs-website --skill test-docs-dryrun
Please help me install this Agent Skill. Skill: test-docs-dryrun Source: https://github.com/stacklok/docs-website/tree/main/.claude/skills/test-docs-dryrun Command: npx skills add https://github.com/stacklok/docs-website --skill test-docs-dryrun
This Skill prevents documentation drift by automatically detecting invalid ToolHive Kubernetes resource examples before they reach users.
Run the docs dry-run validation skill to check all ToolHive documentation YAML examples for schema issues.
High-intent search queries and answers about installing and using this skill.
Validating Kubernetes YAML examples against CRD schemas involves extracting YAML code blocks from MDX documentation files and performing server-side dry runs using kubectl. This process detects field name errors, type mismatches, and API schema changes before release.
Documentation dry run testing for Kubernetes Operator guides is an automated validation process that checks ToolHive YAML examples against installed Custom Resource Definitions. It prevents documentation drift by catching invalid configuration examples after CRD or API schema updates.
Yes, you need a running Kubernetes cluster with ToolHive CRDs installed to test YAML documentation examples. The server-side dry run validation requires kubectl to communicate with the cluster and verify configurations against active schemas.
Yes, Python is used to extract YAML blocks from MDX files for kubectl validation. The Skill leverages Python scripts to parse documentation and isolate YAML examples, which are then validated against Kubernetes CRD schemas via server-side dry runs.
ToolHive documentation YAML fails CRD validation after an API update when schema changes introduce new required fields, alter types, or rename properties. Running documentation dry-run validation identifies these mismatches so you can update the examples accordingly.
stacklokDeploy VirtualMCPServer configurations locally in a Kind cluster for testing.
christian-deleonQuery and mutate Kubernetes resources through the Flux MCP server.
akin-ozerValidate Kubernetes YAML manifests for syntax and schema errors.
ToanPV90Validate Kubernetes YAML manifests for syntax, schema, and dry-run errors.
