present-json

Category: Data & AI | Uploader: hrhrng | Downloads: 0 | Version: v1.0（Latest）

Present JSON results to humans via an interactive browser viewer. Use this when you have JSON output (API responses, data analysis, configs, etc.) that would benefit from visual exploration rather than raw text in the terminal. Usage: /present-json [json-content-or-file-path] [tab-name]

Changelog: Source: GitHub https://github.com/hrhrng/super-json

Directory Structure

Current level: skills/present-json/

📁 scripts/
- 📄 present.ps1 1.8 KB
- 📄 present.sh 1.7 KB
📄 SKILL.md 2.8 KB

SKILL.md

---
name: present-json
description: "Present JSON results to humans via an interactive browser viewer. Use this when you have JSON output (API responses, data analysis, configs, etc.) that would benefit from visual exploration rather than raw text in the terminal. Usage: /present-json [json-content-or-file-path] [tab-name]"
allowed-tools: Bash
---

# Present JSON

Present JSON to humans in Super JSON Editor — an interactive browser-based viewer with syntax highlighting, layer navigation, and JSON Hero integration.

**Built for agents, designed for humans.** Instead of dumping raw JSON in the terminal, give the user a clickable link to explore the data visually.

## When to use

- You produced JSON output the user needs to review (API responses, query results, generated configs)
- The JSON is complex/nested and hard to read as plain text
- You want the user to be able to edit, search, or navigate the JSON interactively

## Instructions

1. Determine the JSON content:
   - If `$0` is a file path, pass it directly to the script
   - Otherwise, treat `$ARGUMENTS` as inline JSON or use the JSON from the current context
2. Determine the tab name:
   - Use `$1` if provided
   - Otherwise, derive a meaningful name from the context (e.g., "API Response", "User Config")
   - Default to "Result" if nothing else fits
3. Run the appropriate script (see below)
4. Present a brief description of the content to the user

## Running the script

**Detect the platform first**, then run:

### macOS / Linux

```bash
# Inline JSON
bash scripts/present.sh '{"key": "value"}' --tab "My Data"

# From a file
bash scripts/present.sh /path/to/data.json --tab "My Data"

# With Hero mode (rich interactive viewer with tree navigation)
bash scripts/present.sh '{"key": "value"}' --tab "My Data" --hero
```

### Windows (PowerShell)

```powershell
# Inline JSON
./scripts/present.ps1 '{"key": "value"}' -Tab "My Data"

# From a file
./scripts/present.ps1 C:\path\to\data.json -Tab "My Data"

# With Hero mode
./scripts/present.ps1 '{"key": "value"}' -Tab "My Data" -Hero
```

### Platform detection
- **macOS/Linux**: use `present.sh`
- **Windows** (PowerShell / `$PSVersionTable` exists): use `present.ps1`

## Important notes

- The script handles compression, temp file creation, browser opening, and cleanup automatically
- All stale `super-json-*.html` temp files are cleaned up ~5 seconds after each invocation
- The URL is entirely client-side — no data is sent to any server (except to jsonhero.io when `--hero`/`-Hero`)
- For very large JSON (>6KB uncompressed), the URL may still exceed browser limits even with compression

## URL parameters reference

| Parameter | Encoding | Description |
|-----------|----------|-------------|
| `c` | Gzip + Base64url | Compressed JSON data |
| `t` | URL-encoded string | Custom tab name |
| `h` | `1` to enable | Auto-switch to Hero mode and load JSON Hero viewer |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

present-json

Directory Structure

SKILL.md

Report

Notice