Setup & Installation
openclaw skills install @wanng-ide/json-repair-kit
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install json-repair-kit
What This Skill Does
Repairs malformed JSON files by parsing them as JavaScript objects and re-serializing as strict JSON. Handles trailing commas, single quotes, unquoted keys, JS-style comments, and hex/octal numbers. Operates on single files or entire directories recursively.
Uses vm.runInNewContext instead of direct eval, making it safer than regex-based fixers while handling a broader set of syntax errors in one pass.
When to use it
- Fixing config files with trailing commas added by hand-editing
- Converting JS object literals copied into .json files
- Batch-repairing all JSON files in a project directory
- Normalizing JSON exported from tools using loose syntax
- Recovering manually edited data files with mixed quote styles
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Repair my broken config.json that has trailing commas and unquoted keys
AGENT
- 1Identifies the broken JSON file at the specified path
- 2Creates a .bak backup of the original file
- 3Parses the file content using vm.runInNewContext as a JavaScript object
- 4Re-serializes the result as valid JSON
- 5Validates the output before writing it back to disk
OUTPUT
config.json is overwritten with valid JSON; config.json.bak preserves the original