/install jrv-yaml-toolkit
jrv-yaml-toolkit
Everything you need to work with YAML files: validate syntax, format/prettify, convert to/from JSON, query with dot-path expressions, merge multiple files, and check against a schema.
Quick Start
# Validate YAML syntax
python3 scripts/yaml_toolkit.py validate config.yaml
# Format/prettify YAML
python3 scripts/yaml_toolkit.py format messy.yaml
# Convert YAML to JSON
python3 scripts/yaml_toolkit.py to-json config.yaml
# Convert JSON to YAML
python3 scripts/yaml_toolkit.py from-json data.json
# Query a value by dot-path
python3 scripts/yaml_toolkit.py get config.yaml "server.host"
# Set a value
python3 scripts/yaml_toolkit.py set config.yaml "server.port" 8080
# Merge multiple YAML files (later files override earlier)
python3 scripts/yaml_toolkit.py merge base.yaml override.yaml
# Lint against a simple schema file
python3 scripts/yaml_toolkit.py lint config.yaml --schema schema.yaml
# List all keys (flattened dot-path)
python3 scripts/yaml_toolkit.py keys config.yaml
# Minify YAML (single-line flow style)
python3 scripts/yaml_toolkit.py minify config.yaml
Commands
| Command | Description |
|---|---|
validate \x3Cfile> |
Check YAML syntax, report errors with line numbers |
format \x3Cfile> |
Pretty-print YAML with consistent indentation |
to-json \x3Cfile> |
Convert YAML to JSON |
from-json \x3Cfile> |
Convert JSON to YAML |
get \x3Cfile> \x3Cpath> |
Get value at dot-path (e.g. server.host) |
set \x3Cfile> \x3Cpath> \x3Cval> |
Set value at dot-path, output updated YAML |
merge \x3Cfile1> \x3Cfile2> ... |
Deep-merge YAML files (right overrides left) |
lint \x3Cfile> --schema \x3Cs> |
Validate keys against a schema YAML |
keys \x3Cfile> |
List all keys as flattened dot-paths |
minify \x3Cfile> |
Output compact single-line YAML |
Options
| Flag | Description |
|---|---|
--output \x3Cfile> |
Write output to file instead of stdout |
--indent N |
Indentation spaces (default: 2) |
--allow-unicode |
Allow unicode in output (default: true) |
Use Cases
- DevOps: Validate Kubernetes and Docker Compose configs before applying
- CI/CD: Merge environment-specific YAML overrides
- Config management: Query and patch config values programmatically
- Data pipelines: Convert between JSON and YAML for different tools
- Documentation: List all config keys for auto-generated docs
Exit Codes
0— Success1— Validation error or key not found2— File not found or parse error
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install jrv-yaml-toolkit - After installation, invoke the skill by name or use
/jrv-yaml-toolkit - Provide required inputs per the skill's parameter spec and get structured output
What is Jrv Yaml Toolkit?
Full-featured YAML toolkit for validating, formatting, converting, merging, and querying YAML files. Supports YAML-to-JSON, JSON-to-YAML, schema validation,... It is an AI Agent Skill for Claude Code / OpenClaw, with 153 downloads so far.
How do I install Jrv Yaml Toolkit?
Run "/install jrv-yaml-toolkit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Jrv Yaml Toolkit free?
Yes, Jrv Yaml Toolkit is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Jrv Yaml Toolkit support?
Jrv Yaml Toolkit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Jrv Yaml Toolkit?
It is built and maintained by John Wang (@johnnywang2001); the current version is v1.0.0.