YAMLCheck

---

name: YAMLCheck

description: "Validate YAML syntax using python3, lint configs, and convert YAML to JSON. Use when checking syntax, finding errors, or converting formats."

version: "3.0.2"

author: "BytesAgain"

homepage: https://bytesagain.com

source: https://github.com/bytesagain/ai-skills

tags: ["yaml","validator","lint","formatter","json","developer"]

categories: ["Developer Tools", "Utility"]

---

# YAMLCheck

A real YAML validator and toolkit. Check syntax, convert YAML to JSON, lint for style issues, and list top-level keys. Uses PyYAML when available, falls back to basic parsing when not.

Commands

| Command | Description |

|---------|-------------|

| `yamlcheck validate <file>` | Validate YAML syntax — reports document count, types, key counts, file size. Falls back to basic tab/colon checks without PyYAML |

| `yamlcheck to-json <file>` | Convert YAML to formatted JSON output. Handles multi-document YAML files |

| `yamlcheck lint <file>` | Check for common style issues: tabs, trailing whitespace, Windows line endings, odd indentation, missing spaces after colons, long lines |

| `yamlcheck keys <file>` | List top-level keys with types and value previews |

Requirements

Without PyYAML, the tool still works but uses basic regex-based checks instead of full YAML parsing.

Examples

# Validate a docker-compose file
yamlcheck validate docker-compose.yml

# Convert YAML config to JSON
yamlcheck to-json values.yaml

# Check for style issues
yamlcheck lint playbook.yml

# See what keys are defined
yamlcheck keys config.yaml