jrv-yaml-toolkit

by johnnywang2001

Install this Skill

curl -fsSL -o jrv-yaml-toolkit.zip https://skill.seembox.com/api/v1/skills/jrv-yaml-toolkit/download && unzip jrv-yaml-toolkit.zip

Download jrv-yaml-toolkit.zip

SKILL.md About

---
name: jrv-yaml-toolkit
description: Full-featured YAML toolkit for validating, formatting, converting, merging, and querying YAML files. Supports YAML-to-JSON, JSON-to-YAML, schema validation, path queries, and multi-document YAML.
---

# 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

```bash
# 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 <file>` | Check YAML syntax, report errors with line numbers |
| `format <file>` | Pretty-print YAML with consistent indentation |
| `to-json <file>` | Convert YAML to JSON |
| `from-json <file>` | Convert JSON to YAML |
| `get <file> <path>` | Get value at dot-path (e.g. `server.host`) |
| `set <file> <path> <val>` | Set value at dot-path, output updated YAML |
| `merge <file1> <file2> ...` | Deep-merge YAML files (right overrides left) |
| `lint <file> --schema <s>` | Validate keys against a schema YAML |
| `keys <file>` | List all keys as flattened dot-paths |
| `minify <file>` | Output compact single-line YAML |

## Options

| Flag | Description |
|------|-------------|
| `--output <file>` | 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` — Success
- `1` — Validation error or key not found
- `2` — File not found or parse error

_meta.json Metadata

{
  "ownerId": "kn7d1eg4e73mffv8r2yspkcv7582nmp1",
  "publishedAt": 1773839330550,
  "slug": "jrv-yaml-toolkit",
  "version": "1.0.0"
}