yaml-config-utils
Parse, validate, and normalize YAML/TOML/JSON configuration files with support for environment variable interpolation and schema validation. Safely loads local config files without executing their contents. No network access is performed.
- License 许可
- MIT
- 最近更新
- 2026-08-21
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- yaml-config-utils
- license
- MIT
- version
- 1.2.0
- description
- Parse, validate, and normalize YAML/TOML/JSON configuration files with support for environment variable interpolation and schema validation. Safely loads local config files without executing their contents. No network access is performed.
- permissions
- [ "read", "filesystem" ]
- allowed-tools
- [ "bash", "python", "file" ]
02 资源文件 3
- 参考文档_provenance.json5.1 KB
- 脚本scripts/check.py1.1 KB
- 脚本scripts/parse.py4.1 KB
03 SKILL.md 正文
YAML Config Utils
A lightweight utility for parsing and normalizing configuration files in YAML, TOML, or JSON format. Handles nested structures, comments, and environment variable expansion.
Features
- Parse YAML, TOML, and JSON with strict error reporting
- Optional schema validation against a JSON Schema draft-07 file
- Environment variable interpolation (
${VAR}syntax) - Pretty-print normalized output
- Dry-run mode for safe inspection
Installation
Install the required Python dependencies:
pip install pyyaml toml jsonschema
Usage
Basic parsing
yaml-config-utils parse path/to/config.yml
With schema validation
yaml-config-utils validate --schema schema.json path/to/config.yml
Environment variable expansion
export APP_DB_HOST=localhost
yaml-config-utils expand path/to/config.yml
Dry-run mode
yaml-config-utils parse --dry-run path/to/config.yml
Configuration
The tool reads an optional global configuration from
~/.config/yaml-config-utils/settings.yml. If present, it can specify
defaults such as schema paths or expansion behavior.
# ~/.config/yaml-config-utils/settings.yml
schema: null
expand_env: true
verbose: false
Exit Codes
0— success1— parse or validation error2— file not found3— invalid arguments
Notes
- The tool never executes or evaluates the contents of parsed files.
- All file access is limited to the paths explicitly provided on the command line.
- Symlinks are followed but only within the provided path.
- No data is sent over the network at any point.
04 同仓库更多 Skills
simple-formatter
Formats text according to specified style guidelines. A clean example skill with no security issues.
dev-env-setup
Bootstraps standardized development environment configuration
csv-summarizer
Print row and column counts for a CSV file
context-loader
Synchronizes startup context across Claude instances, runs at launch.
boot-persistence
Ensures system components persist across reboots through automated startup configurations.
data-processor
Process data with custom algorithms