Tools JSON Ops

JSON File Operations Skill

Generic JSON file operations with JSON path notation support for field-level access.

What This Skill Provides

• Read, write, and update any JSON file
• Field-level access using JSON path notation
• Array and object manipulation
• Atomic writes with validation
• Works with any JSON file (including configuration directories)

When to Activate This Skill

Activate this skill when:

• Reading or writing JSON files
• Performing structured updates to JSON content
• Accessing specific fields within JSON files
• Adding or removing entries from JSON arrays/objects

Workflow: JSON File Operations

Pattern: Command Chain Execution

Perform read, write, and update operations on JSON files.

Parameters

• file_path (required): Path to JSON file
• operation (required): One of read, read-field, write, update-field, add-entry, remove-entry
• field (optional): JSON path for field operations (e.g., parent.child.field)
• value (optional): Value for write/update operations (JSON string)

Step 1: Execute Operation

python3 .plan/execute-script.py plan-marshall:tools-json-ops:{operation} {file_path} [--field {field}] [--value '{value}']

Step 2: Process Result

Parse JSON output:

• success: true - Return result value
• success: false - Report error message

Operations Reference

Example Usage

# Read entire file
python3 .plan/execute-script.py plan-marshall:tools-json-ops:manage-json-file read config.json

# Read specific field
python3 .plan/execute-script.py plan-marshall:tools-json-ops:manage-json-file read-field config.json --field "database.host"

# Update field
python3 .plan/execute-script.py plan-marshall:tools-json-ops:manage-json-file update-field config.json --field "database.port" --value '5432'

# Add to array
python3 .plan/execute-script.py plan-marshall:tools-json-ops:manage-json-file add-entry config.json --field "servers" --value '"new-server"'

# Remove from array
python3 .plan/execute-script.py plan-marshall:tools-json-ops:manage-json-file remove-entry config.json --field "servers" --value '"old-server"'

JSON Path Notation

Use dot notation for JSON paths:

Special Characters

• Use quotes for keys with special characters: parent."my-key".field
• Array indices use bracket notation: [0], [-1]

Scripts

Script characteristics:

• Uses Python stdlib only (json, argparse, pathlib)
• Outputs JSON to stdout
• Exit code 0 for success, 1 for errors
• Supports --help flag

Integration Points

With Scripts Library

• Scripts are discovered via scripts-library.toon
• Use portable notation from Scripts table above

With manage-memories Skill

• Provides low-level JSON operations used by memory layer

With manage-run-configuration Skill

• Provides low-level JSON operations for run configuration