JSON/YAML Tools Skill

Validate, format, and convert between JSON, YAML, and TOML formats.

When to Use

✅ USE this skill when:

• "Format this JSON"

• "Validate this YAML file"

• "Convert JSON to YAML"

• "Parse this config file"

• "Query JSON data"

When NOT to Use

❌ DON'T use this skill when:

• Editing files directly → use text editor

• Large data processing → use specialized tools

Commands

Validate

{baseDir}/validate.sh <file> {baseDir}/validate.sh config.json --format json {baseDir}/validate.sh config.yaml --format yaml

Format/Prettify

{baseDir}/format.sh config.json {baseDir}/format.sh config.yaml --indent 4 {baseDir}/format.sh config.json --compact

Convert

{baseDir}/convert.sh config.json --to yaml {baseDir}/convert.sh config.yaml --to json {baseDir}/convert.sh config.toml --to json {baseDir}/convert.sh config.json --to toml

Query

{baseDir}/query.sh data.json '.users[0].name' {baseDir}/query.sh data.json '.items | length' {baseDir}/query.sh data.yaml '.config.settings'

Flatten/Unflatten

{baseDir}/flatten.sh data.json {baseDir}/unflatten.sh data.json

Merge

{baseDir}/merge.sh file1.json file2.json --out merged.json {baseDir}/merge.sh base.yaml overlay.yaml

Output Formats

• Formatted: Pretty-printed with indentation

• Compact: Single line, no whitespace

• Flat: Dot-notation keys

Examples

Format JSON file:

{baseDir}/format.sh config.json

Output: Properly indented JSON

Convert YAML to JSON:

{baseDir}/convert.sh config.yaml --to json

Query JSON with jq-like syntax:

{baseDir}/query.sh data.json '.users[].name' {baseDir}/query.sh data.json '.items | map(.price) | add'

Validate JSON:

{baseDir}/validate.sh config.json

Output: Valid ✓ or error details

Notes

• Uses Python's json, yaml, and tomli libraries

• Supports YAML 1.2 specification

• Handles circular references in merge

• Query syntax is similar to jq