← Back to Skills Marketplace
wanng-ide

Json Linter

by WANGJUNJIE · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
826
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install json-linter
Description
Validates JSON syntax across the workspace. Use this skill to check for syntax errors in configuration files, memory files, or data assets.
README (SKILL.md)

JSON Linter

A simple utility to recursively scan the workspace for .json files and validate their syntax using JSON.parse().

Usage

# Scan the entire workspace (from current working directory)
node skills/json-linter/index.js

# Scan a specific directory
node skills/json-linter/index.js --dir path/to/dir

Output

JSON report containing:

  • scanned_at: Timestamp
  • total_files: Number of .json files scanned
  • valid_files: Number of valid files
  • invalid_files: Number of invalid files
  • errors: Array of error objects:
    • path: Relative path to file
    • error: Error message (e.g., "Unexpected token } in JSON at position 42")

Example Output

{
  "scanned_at": "2026-02-14T21:45:00.000Z",
  "total_files": 150,
  "valid_files": 149,
  "invalid_files": 1,
  "errors": [
    {
      "path": "config/broken.json",
      "error": "Unexpected token } in JSON at position 42"
    }
  ]
}
Usage Guidance
This skill appears to do exactly what it says: recursively read .json files and report syntax errors. Before installing or running it, consider: 1) it will read any .json files in the workspace (so it can see JSON-formatted secrets/configs); 2) the bundled code runs under node — review index.js and scripts/test.js yourself or run them in a sandbox/container if you are unsure; 3) there is no network activity in the code, and no external downloads are performed, which reduces risk; 4) if you want to avoid scanning some paths, the script only skips a few hard-coded names (node_modules, .git, temp, logs) — adjust or run it against an explicit directory to limit scope. If you need higher assurance, run the test suite (node scripts/test.js) in an isolated environment first.
Capability Analysis
Type: OpenClaw Skill Name: json-linter Version: 1.0.0 The skill bundle provides a JSON linter that recursively scans a specified directory for `.json` files and validates their syntax. The `index.js` script uses standard Node.js file system operations (`fs.readdirSync`, `fs.readFileSync`) and `JSON.parse()` for validation. It correctly handles command-line arguments for the target directory using `path.resolve` and passes them directly to `fs` functions, preventing shell injection. There are no external dependencies, network calls, data exfiltration attempts, or prompt injection instructions in `SKILL.md`. The `scripts/test.js` file is a benign unit test. All files align with the stated purpose without exhibiting any malicious intent or significant vulnerabilities.
Capability Assessment
Purpose & Capability
Name and description match the delivered code: index.js and SKILL.md implement a recursive workspace scan for .json files and validate them with JSON.parse(). No extra binaries, env vars, or unrelated capabilities are requested.
Instruction Scope
SKILL.md instructs running the included Node script to scan a directory. The implementation reads filesystem directories and files, parses JSON, and emits a report. It does not access the network, other processes, or system credentials. It will read any .json files in the workspace (which is expected for this purpose).
Install Mechanism
There is no install spec or external download; this is essentially an instruction-only skill with bundled scripts. package.json declares no dependencies. Risk from installation is minimal because nothing is fetched from remote sources.
Credentials
The skill declares no required environment variables or credentials and the code does not read env vars. Note: because it scans the workspace, it can read any JSON files present — including files that may contain secrets (e.g., credentials stored as JSON). This access is coherent with the skill's purpose but is something the user should be aware of.
Persistence & Privilege
Flags are default (always: false). The skill does not modify other skills or global agent configuration. It can be invoked autonomously by the agent (platform default), but that is not a unique privilege for this skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install json-linter
  3. After installation, invoke the skill by name or use /json-linter
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of json-linter. - Scans `.json` files recursively in the workspace or a specified directory. - Validates JSON syntax using `JSON.parse()`. - Generates a JSON summary report including scan time, file counts, and error details for invalid files.
Metadata
Slug json-linter
Version 1.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Json Linter?

Validates JSON syntax across the workspace. Use this skill to check for syntax errors in configuration files, memory files, or data assets. It is an AI Agent Skill for Claude Code / OpenClaw, with 826 downloads so far.

How do I install Json Linter?

Run "/install json-linter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Json Linter free?

Yes, Json Linter is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Json Linter support?

Json Linter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Json Linter?

It is built and maintained by WANGJUNJIE (@wanng-ide); the current version is v1.0.0.

💬 Comments