Jrv Yaml Toolkit

提供 YAML 命令行工具：校验语法并报错行号、格式化、YAML 与 JSON 互转、点路径查询与赋值、多文件深度合并、按简单 schema 检查键、列出扁平化键路径及压缩输出，结果可打印或写入文件。

johnnywang2001

热度 79.97

最近更新 2026-05-11 17:33:24

分类：效率依赖：代码执行 / 读写文件应用场景：数据处理 / 文件转换 / 自动化脚本 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add jrv-yaml-toolkit

Metadata

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

# 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