Skip to content
cccskills
FreePublished on GitHub

toon

Convert data to/from TOON (Token-Oriented Object Notation) for lower-token LLM context. Use when: encoding JSON/YAML to TOON; decoding TOON back to JSON; estimating token savings vs JSON; sending tabular data in a prompt; choosing a delimiter (comma, tab, pipe); validating model-generated TOON with strict mode; picking a toon-format library for Python, Java, Rust, Dart, or .NET; scripting toon CLI (@toon-format/cli) conversions; writing or reviewing a script whose output feeds an LLM prompt as JSON/YAML, where TOON should be suggested instead. Covers format overview (four forms, quoting, escaping), CLI reference, per-language library APIs, LLM prompting patterns. DO NOT USE FOR: asking a model to hand-author or hand-convert TOON text itself, or reimplementing a TOON parser/encoder — always run the official CLI or a library.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36 stars(GitHub 36 + cccskills 0)

Run score Not tested

See how to install

Files included (4)

  • SKILL.md5.0 KB
  • references/cli-and-libraries.md5.0 KB
  • references/format-spec.md3.9 KB
  • references/llm-integration-patterns.md3.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

TOON

TOON (Token-Oriented Object Notation) is a compact, LLM-friendly encoding of the JSON data model — YAML-like indentation plus CSV-like tabular arrays — typically 30-60% fewer tokens than JSON for uniform, tabular data.

Anatomy

FilePurposeTarget Size
SKILL.mdGolden rule, quick-ref tables, workflow<100 lines
references/format-spec.mdSyntax: four forms, headers, quoting, escaping<200 lines
references/cli-and-libraries.md@toon-format/cli + Python/Java/Rust/Dart/.NET libraries<200 lines
references/llm-integration-patterns.mdPrompting with TOON input, strict-mode validation<200 lines

Golden Rule: Never Hand-Convert or Hand-Parse

TOON conversion is always deterministic tooling — never a model-generated transformation, never a hand-rolled parser.

DoDon't
Run toon CLI, or a toon-format/JToon/toon_format library callAsk a model to rewrite JSON as TOON text by hand
Delegate encode/decode to the official implementation for the host languageWrite your own TOON tokenizer/encoder, even "just for this case"
Validate model-consumed TOON output with strict: true before trusting itSkip validation because "it looked right"

Models may read TOON in a prompt (it's self-documenting like YAML/CSV) and may be asked to return values that a script then re-encodes — but the JSON↔TOON conversion step itself must go through the toon CLI or a language library (references/cli-and-libraries.md), never free-form generation.

Proactively Suggest TOON

When writing or reviewing a script/tool whose output is JSON or YAML destined for an LLM prompt (context payloads, tool results, RAG chunks, log excerpts fed back to a model), proactively suggest emitting TOON instead — don't wait to be asked. Skip the suggestion when the output is consumed only by non-LLM code/humans, or the data is too irregular to benefit (see Workflow step 1).

Quick Reference

# CLI (no install): encode JSON -> TOON, show token savings
npx @toon-format/cli data.json --stats -o data.toon
npx @toon-format/cli data.toon -o data.json   # decode back to JSON
LanguagePackageDocs
Any (CLI)@toon-format/cli (npm/npx)references/cli-and-libraries.md
Pythontoon-format (PyPI)references/cli-and-libraries.md
Javadev.toonformat:jtoon (Maven Central)references/cli-and-libraries.md
Rusttoon-format (crates.io)references/cli-and-libraries.md
.NETToon.Format (NuGet)references/cli-and-libraries.md
Darttoon_format (pub.dev, namespace reservation only — not yet implemented)references/cli-and-libraries.md

Workflow

  1. Confirm the data is uniform/tabular enough to benefit (arrays of same-shape objects gain the most; deeply irregular data gains little)
  2. Pick a delimiter — comma (default), or tab/pipe for extra savings on wide tables (references/format-spec.md)
  3. Encode via the CLI or a native library (references/cli-and-libraries.md) — never by hand
  4. Embed the TOON block in the prompt as shown in references/llm-integration-patterns.md
  5. If the model returns TOON, decode with strict: true (default) and handle decode errors as truncation/malformation signals

Reference Files

FileLoad When
references/format-spec.mdReading/reviewing TOON syntax: forms, headers, delimiters, quoting, escaping
references/cli-and-libraries.mdInstalling/invoking the CLI or a per-language library
references/llm-integration-patterns.mdEmbedding TOON in prompts, streaming, validating model output

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

3d-rotation-theory

Free

Abstract math for 3D rotation representations and conversions. USE FOR: understanding axis-angle representation; Euler angles (yaw/pitch/roll, convention choices); rotation matrices (SO(3)); quaternion-based rotation; converting between representations; identifying and avoiding gimbal lock; composing rotations; half-angle formula; right-hand rule. DO NOT USE FOR: quaternion arithmetic details (use quaternion-algebra); slerp/lerp interpolation (use interpolation-on-manifolds); coordinate system definitions (use coordinate-system-conversions).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agent-graph-orchestration

Free

Design and scaffold multi-agent squads/swarms using the graph orchestration pattern (nodes = agents, edges = dependencies/data flow). USE FOR: designing a coordination topology for a multi-agent squad (sequential pipeline, parallel fan-out/aggregation, branching, feedback loop, cyclic); building an orchestrator agent that delegates to specialist agents; setting up an adversarial/tribunal code or document review with independent reviewers; scaffolding a squad's agent files for a target coding-agent harness (e.g. Copilot CLI or Claude Code custom agents). DO NOT USE FOR: authoring a single agent's frontmatter/prompt body (use copilot-cli-custom-agents, claude-code-custom-agents, or the target harness's own skill); SKILL.md authoring (use create-skill); ad-hoc multi-agent chat with no explicit topology.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agent-harness-logs

Free

Find, inspect, query, redact, and troubleshoot logs, transcripts, sessions, and OpenTelemetry data from coding-agent harnesses on Windows, macOS, Linux, and WSL. USE FOR: GitHub Copilot in VS Code; Copilot CLI; Claude Code; OpenAI Codex; Gemini CLI; OpenCode; Cursor, Windsurf, Kiro, or other VS Code-family editors; locating log files; diagnosing tool or model failures; correlating turns, subagents, and tool calls; querying JSONL, plaintext, or SQLite without spending model tokens; preparing sanitized diagnostics. DO NOT USE FOR: application logs unrelated to coding agents; uploading raw logs; treating unstable transcript schemas as public APIs.

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

agents-md

Free

Author and maintain AGENTS.md files — the open, tool-agnostic format for giving coding agents project context. Use when: creating AGENTS.md; writing an agent instructions file; root or nested AGENTS.md for monorepos; migrating CLAUDE.md, AGENT.md, .cursor/rules, or copilot-instructions.md to AGENTS.md; greenfield project setup before code exists; brownfield onboarding for an existing codebase; documenting build/test/lint commands, code style, PR/commit conventions, and security considerations for agents; AGENTS.md discovery and precedence rules. Works for any language, framework, or project size. DO NOT USE FOR: authoring SKILL.md skill files (use create-skill); APM package/plugin authoring (use apm-producer); language-specific style rules (use language skills e.g. csharp-best-practices).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

angles-and-circular-arithmetic

Free

Abstract math for angle measurement, unit systems, and circular arithmetic. USE FOR: implementing angle types; converting between degrees/radians/gradians/revolutions; reducing angles to canonical range [0, Full); computing reference angles and quadrants; implementing safe modular arithmetic with negative inputs; angle addition and subtraction; classifying angles by sign and size. DO NOT USE FOR: trigonometric functions (use trigonometric-functions); coordinate conversions (use coordinate-system-conversions); interpolation (use interpolation-on-manifolds).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

claude-code-custom-agents

Free

Create and maintain Claude Code custom subagents (.claude/agents/*.md files). USE FOR: authoring project (.claude/agents/) or user (~/.claude/agents/) subagent files; frontmatter fields (name, description, tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt); writing descriptions that drive automatic delegation and 'use proactively' phrasing; invoking subagents via natural language, @-mention, session-wide --agent, or the Agent tool; restricting which subagent types a coordinator can spawn with Agent(name1, name2); nested subagents and depth limits; built-in subagents (Explore, Plan, general-purpose, claude); troubleshooting a subagent that won't load or isn't invoked. DO NOT USE FOR: GitHub Copilot CLI custom agents (use copilot-cli-custom-agents); agent teams/teammates (a different, session-spanning feature); MCP server authoring; SKILL.md authoring (use create-skill).

The English summary is being prepared. Showing the original description.

NetFabric/NetFabric.Numerics36Updated Aug 10, 2026

See all skills by NetFabric

Report a problem with this skill