How do I install the JSON YAML skill?

Run npx skillmds@latest add winsorllc/json-yaml in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is JSON YAML safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with JSON YAML?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is JSON YAML free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published JSON YAML?

winsorllc (@winsorllc) published this skill. Their other Agent Skills are listed on their SkillMD profile.

JSON YAML by winsorllc — Agent Skill

Name: JSON YAML
Author: winsorllc

File contents

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

---name: json-yamldescription: Validate, format, and convert between JSON, YAML, and TOML. Parse and query structured data files. No API key required.---# JSON/YAML Tools SkillValidate, 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```bash{baseDir}/validate.sh <file>{baseDir}/validate.sh config.json --format json{baseDir}/validate.sh config.yaml --format yaml```### Format/Prettify```bash{baseDir}/format.sh config.json{baseDir}/format.sh config.yaml --indent 4{baseDir}/format.sh config.json --compact```### Convert```bash{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```bash{baseDir}/query.sh data.json '.users[0].name'{baseDir}/query.sh data.json '.items | length'{baseDir}/query.sh data.yaml '.config.settings'```### Flatten/Unflatten```bash{baseDir}/flatten.sh data.json{baseDir}/unflatten.sh data.json```### Merge```bash{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:**```bash{baseDir}/format.sh config.json# Output: Properly indented JSON```**Convert YAML to JSON:**```bash{baseDir}/convert.sh config.yaml --to json```**Query JSON with jq-like syntax:**```bash{baseDir}/query.sh data.json '.users[].name'{baseDir}/query.sh data.json '.items | map(.price) | add'```**Validate JSON:**```bash{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

Frequently asked questions

JSON YAML