# Convert JSON into LLM Context

Large JSON payloads waste tokens and hide important facts. This skill converts JSON or jsonb exports into compact summaries for Claude, Codex, and Claude Code.

## Install

```bash
npx skillstore add vc999999999/json-to-llm-context
```

## Metadata

- Status: approved
- Slug: vc999999999-json-to-llm-context
- Skillstore revision: r1
- Version status: missing
- Tree hash: 3571936b5c8ef53c73e1d7585d9edc1ad32bc303803ad002399233a23b505050
- Author: vc999999999
- GitHub username: vc999999999
- License: MIT
- Repository: https://github.com/vc999999999/json-to-llm-context/tree/main/json-to-llm-context
- Ref: 36e07d5e13068e5be64447e8f20b427cf2cbd21a
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 81
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/vc999999999-json-to-llm-context
- Manifest: https://skillstore.pages.dev/api/skills/vc999999999-json-to-llm-context/manifest

## Capabilities

- Reads JSON from a file path or standard input.
- Creates sectioned summaries with Summary, Details, and Collections.
- Condenses arrays into counts, status distributions, and sample records.
- Preserves selected keys or dotted paths when requested.
- Adds optional source path markers for traceability.
- Supports flat and sectioned output styles.

## Use Cases

- Summarize API Responses: Convert a large service response into compact context before asking an LLM to debug behavior or explain state.
- Prepare jsonb Exports: Turn database jsonb payloads into readable summaries for analysis, support review, or product investigation.
- Reduce Prompt Tokens: Compress nested records while keeping identifiers, statuses, relationships, and important fields visible.

## Prompt Templates

### Summarize a JSON File

```
Use json-to-llm-context on this JSON file and return the readable summary.
```

### Create a Shorter Context

```
Convert this JSON into compact LLM context. Use fewer samples and shorter strings if the first output is too long.
```

### Preserve Important Fields

```
Summarize this payload, but preserve status, profile.email, identifiers, and order fields even when they look sparse.
```

### Trace Summary Lines

```
Generate sectioned context with path markers and expanded details so each summary line can be traced to the source JSON.
```

## Limitations

- Requires valid JSON or jsonb-style JSON text.
- Does not process PDFs, DOCX files, images, or prose documents.
- May omit low-signal empty values unless strict or preserve options are used.
- Very large or deeply nested payloads may need tighter depth and sample limits.

## Best Practices

- Use strict mode when missing false or empty values could change the meaning.
- Preserve business-critical keys such as status, identifiers, emails, and relationship fields.
- Lower sample, depth, and string limits before sending very large payloads to an LLM.

## Anti Patterns

- Do not use it for non-JSON documents or OCR tasks.
- Do not assume the summary preserves every source field unless strict and preserve options are used.
- Do not run it on sensitive local files unless the output destination and sharing path are approved.

## Security Audit

- Audited at: 2026-07-07T08:34:43.086\+00:00
- Summary: Manual review found all static findings are false positives from Markdown backticks, examples, JSON field names, and a broad obfuscation heuristic. The skill contains a local Python JSON summarizer that reads user-provided JSON and can write a text summary. No network access, subprocess execution, environment access, prompt injection text, or hidden code was found.

## Stats

- Views: 175
- Downloads: 25
- Favorites: 0
- Popularity score: 0
