# media-transformation

media-transformation rewrites uniform JSON arrays as TOON v2.0, with field names declared once and rows after. Useful when repeated records fill your context.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 126 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/media-transformation/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/media-transformation

## What it does

The skill takes structured data and lays it out as TOON v2.0: a single header carries the field names, each record becomes one line. Arrays of five or more similar objects lose 30-60% of their token weight. Event logs, API payloads, query results and metric tables all qualify, since the shape matters more than the labels.

Three layouts cover most input: a tabular block for objects that share fields, an inline list for plain values, an expanded form when they don't. Separators follow the data — comma by default, tab when values contain commas, pipe for a markdown-like look. Nested keys get folded flat (`server.host`, `database.port`) for another 25-35%.

The skill also refuses. Short arrays, deeply nested trees and objects with little field overlap stay in JSON, and it names the reason in the output. The fast route shells out to a Zig encoder at `.claude/utils/toon/zig-out/bin/toon`; on a fresh checkout that binary isn't built, so the manual step-by-step path is what you get. Terms sit in `LICENSE.txt`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill media-transformation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/media-transformation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/media-transformation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill media-transformation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/media-transformation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill media-transformation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/media-transformation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/media-transformation
```

2. **Manually: put the files in place**
- File: `.github/skills/media-transformation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill media-transformation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/media-transformation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/media-transformation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill media-transformation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/media-transformation/SKILL.md

## When to use it
- compress a user-list API response before it reaches the prompt
- fit a database query result into context without dropping columns
- turn per-route performance metrics into a compact block
- flatten nested config keys into one level
- pick a separator for street addresses containing commas

## Example prompts
- Convert this array to TOON with tab delimiters and folded keys.
- Encode the `/api/users` response as TOON if the fields line up.
- Decide between JSON and TOON for this payload and show the result.

## Similar
- [grepai-search-advanced](https://affpapa.org/en/nevibecode/skills/grepai-search-advanced.md) — skill · 865 installs
- [toon-format](https://affpapa.org/en/nevibecode/skills/toon-format.md) — skill · 1300 installs
- [social-media-context-sms](https://affpapa.org/en/nevibecode/skills/social-media-context-sms.md) — skill · 2100 installs
- [cost-summary](https://affpapa.org/en/nevibecode/skills/cost-summary.md) — skill · 684 installs
- [learn-codebase](https://affpapa.org/en/nevibecode/skills/learn-codebase.md) — skill · 5800 installs
- [ctx-stats](https://affpapa.org/en/nevibecode/skills/ctx-stats.md) — skill · 1900 installs

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
