← Back to Skills Marketplace
98
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install formatgate
Description
Convert between JSON, YAML, and TOML formats. All 6 conversion directions supported. Round-trip safe. Useful for agents that receive data in one format and n...
README (SKILL.md)
FormatGate
Convert data between JSON, YAML, and TOML.
Start the server
uvicorn formatgate.app:app --port 8008
Convert JSON to YAML
curl -s -X POST http://localhost:8008/v1/convert \
-H "Content-Type: application/json" \
-d '{"content": "{\"name\": \"Alice\", \"age\": 30}", "input_format": "json", "output_format": "yaml"}' | jq -r '.result'
Convert YAML to JSON
echo "name: Alice" | curl -s -X POST http://localhost:8008/v1/convert \
-H "Content-Type: application/json" \
-d "{\"content\": $(cat - | jq -Rs), \"input_format\": \"yaml\", \"output_format\": \"json\"}" | jq -r '.result'
Returns success (true/false), result (converted content), and error (if conversion failed — e.g., invalid input).
Usage Guidance
This skill appears to do exactly what it says: a small local HTTP service for converting JSON/YAML/TOML. Before installing, note: (1) it will pip-install dependencies from PyPI — audit or pin versions if you require stricter supply-chain controls; (2) it uses tomllib (Python 3.11+) for TOML parsing, so ensure your python version is compatible; (3) the SKILL.md starts a web server on port 8008 — avoid binding to 0.0.0.0 on untrusted networks to prevent exposure; and (4) while behavior is coherent, always vet third-party packages (fastapi/uvicorn/pyyaml) for the environment where you'll run this service.
Capability Analysis
Type: OpenClaw Skill
Name: formatgate
Version: 1.0.0
The 'formatgate' skill is a utility for converting data between JSON, YAML, and TOML formats via a FastAPI service. The implementation in `formatgate/app.py` uses standard libraries and safe practices, such as `yaml.safe_load`, to handle data parsing. There are no signs of malicious behavior, data exfiltration, or prompt injection vulnerabilities.
Capability Assessment
Purpose & Capability
Name/description (format conversion) align with the included code and SKILL.md. Required binary (python) and pip packages (fastapi, uvicorn, pydantic, pyyaml) are appropriate for a small local web service that performs parsing/serialization.
Instruction Scope
SKILL.md only instructs running a local FastAPI server and calling POST /v1/convert with content/input/output fields. It does not ask the agent to read arbitrary files, environment variables, or send data to external endpoints.
Install Mechanism
Install spec uses PyPI packages via a pip-style 'uv' entry (fastapi, uvicorn, pydantic, pyyaml). This is a common and proportionate mechanism for a Python web service. No downloads from untrusted URLs or archive extraction were used.
Credentials
The skill declares no required environment variables, credentials, or config paths. The code does not access secrets or other environment data.
Persistence & Privilege
The skill does not request always:true or modify other skills' configs. It runs as a normal user-started local service; autonomous invocation is allowed by platform defaults but not granted extra privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install formatgate - After installation, invoke the skill by name or use
/formatgate - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Updated description to highlight all 6 conversion directions and round-trip safety
- Improved metadata structure; added emoji and clarified installation details
- Simplified and clarified usage instructions with focused conversion examples
- Added concise curl commands for both JSON→YAML and YAML→JSON scenarios
- Removed installation and format tables; streamlined for easier understanding
v0.1.1
- Added metadata section specifying required binaries and installation instructions for openclaw.
- Updated version to 0.1.1.
- Clarified and improved installation instructions (including dependency on pydantic).
- Simplified usage section and updated server run and API endpoint instructions.
- Slightly reworded supported formats and conversion directions for clarity.
v0.1.0
Initial release of FormatGate: a utility API for converting between JSON, YAML, and TOML.
- Converts content between JSON, YAML, and TOML (all 6 directions supported).
- Provides both hosted API and standalone server usage options.
- Simple request/response schema with clear error handling.
- Supports easy content interchange for agents and applications.
Metadata
Frequently Asked Questions
What is Formatgate?
Convert between JSON, YAML, and TOML formats. All 6 conversion directions supported. Round-trip safe. Useful for agents that receive data in one format and n... It is an AI Agent Skill for Claude Code / OpenClaw, with 98 downloads so far.
How do I install Formatgate?
Run "/install formatgate" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Formatgate free?
Yes, Formatgate is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Formatgate support?
Formatgate is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Formatgate?
It is built and maintained by mirni (@mirni); the current version is v1.0.0.
More Skills