← Back to Skills Marketplace
johnnywang2001

Jrv Yaml Toolkit

by John Wang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
153
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install 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,...
README (SKILL.md)

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 — Success
  • 1 — Validation error or key not found
  • 2 — File not found or parse error
Usage Guidance
The skill appears internally consistent and implements a local YAML CLI without network calls or credential access. Before installing: (1) be aware the package source has no homepage and unknown owner—review the bundle yourself if you can; (2) install PyYAML (pip install pyyaml) before use; (3) run the tool on non-sensitive files first and/or in a sandbox, and keep backups before using commands that write output (set/merge/from-json with --output). If you need higher assurance, request a full code review of the complete script (the listing was truncated at the CLI wiring) or ask the author for a source repo or homepage.
Capability Analysis
Type: OpenClaw Skill Name: jrv-yaml-toolkit Version: 1.0.0 The jrv-yaml-toolkit is a standard utility for processing YAML files, providing features like validation, formatting, conversion, and merging. The implementation in scripts/yaml_toolkit.py uses security best practices such as yaml.safe_load() to prevent arbitrary code execution during parsing and does not contain any network calls, obfuscation, or unauthorized file access.
Capability Assessment
Purpose & Capability
Name/description align with the included script: the Python CLI implements validate/format/convert/get/set/merge/lint/keys/minify and supports the documented use cases.
Instruction Scope
SKILL.md instructs the agent to run the bundled script on user-provided files. The instructions do not ask the agent to read unrelated system files, environment variables, or send data externally.
Install Mechanism
There is no install spec (instruction-only), which is lowest risk, but the script requires PyYAML (it exits with an error if pyyaml is missing). The registry metadata did not declare this dependency explicitly—user must install pyyaml themselves.
Credentials
The skill requests no environment variables, no credentials, and references only the files passed on the command line. No excessive or unrelated secrets or paths are requested.
Persistence & Privilege
always is false and the skill does not attempt to modify other skills or system-wide agent settings. It writes only to stdout or to a user-specified output file.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install jrv-yaml-toolkit
  3. After installation, invoke the skill by name or use /jrv-yaml-toolkit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of jrv-yaml-toolkit. - Supports validating YAML syntax with error reporting. - Formats and prettifies YAML files. - Converts between YAML and JSON formats. - Queries and sets values using dot-path expressions. - Deep-merges multiple YAML files with override support. - Validates YAML against a schema file. - Lists all YAML keys in flattened form. - Outputs minified, single-line YAML. - Provides command-line options for output file, indentation, and Unicode handling.
Metadata
Slug jrv-yaml-toolkit
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments