{"id":"80c956d4-61aa-4db4-9226-39d86d783cce","entityType":"agent","slug":"clawhub-lythaeon-toon-utils","name":"Toon","canonicalUrl":"https://xpersona.co/agent/clawhub-lythaeon-toon-utils","canonicalPath":"/agent/clawhub-lythaeon-toon-utils","generatedAt":"2026-04-17T02:35:51.727Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data. Skill: Toon Owner: Lythaeon Summary: Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data. Tags: latest:3.0.0 Version history: v3.0.0 | 2026-02-01T17:11:49.927Z | user **Summary:** Major update removes built-in CLI scripts; shifts usage to global TOON CLI. - Removed internal utility scripts: bin/toon.j","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7400d5fktsezh1662yyq7xz180bgxs:toon-utils","sourceUrl":"https://clawhub.ai/Lythaeon/toon-utils","homepage":"https://clawhub.ai/Lythaeon/toon-utils","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/Lythaeon/toon-utils","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":64,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for struct"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1670,"packageName":null,"latestVersion":"3.0.0","tractionLabel":"1.7K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-02-28T20:44:01.869Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-28T20:44:01.869Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-01T20:44:01.869Z","lastVerifiedAt":null,"highlights":[{"version":"3.0.0","createdAt":"2026-02-01T17:11:49.927Z","changelog":"**Summary:** Major update removes built-in CLI scripts; shifts usage to global TOON CLI. - Removed internal utility scripts: `bin/toon.js` and `lib/commands.js`. - Updated documentation: Agents must now install and use the official global `toon` CLI. - Instructions shifted from custom skill commands to standard Unix piping with global `toon`. - Emphasized token savings, speed, and prompt brevity by preferring global CLI.","fileCount":2,"zipByteSize":1216},{"version":"1.0.1","createdAt":"2026-02-01T16:24:30.200Z","changelog":"- Removed 4 files, including all tests and utility scripts. - Updated API fetching: replaced `fetch` command with more flexible `curl`, supporting all curl arguments. - Adjusted documentation and examples to use `curl` instead of `fetch` for API calls.","fileCount":4,"zipByteSize":3231},{"version":"1.0.0","createdAt":"2026-02-01T16:02:36.352Z","changelog":"Initial release of toon-utils skill. - Introduces token-saving utilities for agents by using the compact TOON format. - Supports reading JSON, listing directories, searching code, and fetching APIs with reduced token usage (30-50% savings for structured data). - Provides clear command guidelines to prioritize TOON-based operations over traditional methods. - Adds examples for correct and incorrect usage. - Implementation leverages the `@toon-format/toon` library for encoding via Node.js.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7400d5fktsezh1662yyq7xz180bgxs:toon-utils","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/contract","trustUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/trust"},"curlExamples":["curl -s \"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/snapshot\"","curl -s \"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/contract\"","curl -s \"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-04-17T02:35:51.727Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/dossier","snapshotUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/snapshot","contractUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/contract","trustUrl":"https://xpersona.co/api/v1/agents/clawhub-lythaeon-toon-utils/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: Toon\n\nOwner: Lythaeon\n\nSummary: Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data.\n\nTags: latest:3.0.0\n\nVersion history:\n\nv3.0.0 | 2026-02-01T17:11:49.927Z | user\n\n**Summary:** Major update removes built-in CLI scripts; shifts usage to global TOON CLI.\n\n- Removed internal utility scripts: `bin/toon.js` and `lib/commands.js`.\n- Updated documentation: Agents must now install and use the official global `toon` CLI.\n- Instructions shifted from custom skill commands to standard Unix piping with global `toon`.\n- Emphasized token savings, speed, and prompt brevity by preferring global CLI.\n\nv1.0.1 | 2026-02-01T16:24:30.200Z | user\n\n- Removed 4 files, including all tests and utility scripts.\n- Updated API fetching: replaced `fetch` command with more flexible `curl`, supporting all curl arguments.\n- Adjusted documentation and examples to use `curl` instead of `fetch` for API calls.\n\nv1.0.0 | 2026-02-01T16:02:36.352Z | user\n\nInitial release of toon-utils skill.\n\n- Introduces token-saving utilities for agents by using the compact TOON format.\n- Supports reading JSON, listing directories, searching code, and fetching APIs with reduced token usage (30-50% savings for structured data).\n- Provides clear command guidelines to prioritize TOON-based operations over traditional methods.\n- Adds examples for correct and incorrect usage.\n- Implementation leverages the `@toon-format/toon` library for encoding via Node.js.\n\nArchive index:\n\nArchive v3.0.0: 2 files, 1216 bytes\n\nFiles: SKILL.md (1651b), _meta.json (129b)\n\nFile v3.0.0:SKILL.md\n\n# TOON (Token-Oriented Object Notation) Skill\n\nThis skill provides instructions for reducing token usage by 30-60% when dealing with structured data (JSON, directory structures, API responses). \n\n## Setup & Installation\n\nTo minimize command overhead and save tokens, you MUST install the official TOON CLI globally before usage:\n\n```bash\n# Check if toon is installed, install if missing\ntoon --version || npm install -g @toon-format/cli\n```\n\n## Guidelines for Agents\n\n- **Always optimize JSON**: Convert JSON output to TOON before including it in your context.\n- **Minimize Command Length**: Use the direct `toon` command instead of `npx` to keep your own prompt usage low.\n- **Prefer pipes**: Use standard Unix pipes to send data directly to the `toon` converter.\n\n## Commands & Usage\n\n### 1. Reading JSON Files\nInstead of reading raw JSON, pipe it to `toon`.\n```bash\ncat data.json | toon\n```\n\n### 2. Fetching APIs\nPipe external API responses directly into `toon`.\n```bash\ncurl -s https://api.example.com/data | toon\n```\n*Supports all curl flags (e.g., `-X POST`, `-H \"Authorization: ...\"`).*\n\n### 3. Listing Directory Structures\nUse `tree -J` or any JSON-outputting tool and pipe to `toon`.\n```bash\ntree -J path/to/dir | toon\n```\n\n### 4. Converting In-Line Data\nTo compress a JSON string for your context:\n```bash\necho '{\"key\":\"value\"}' | toon\n```\n\n## Why install TOON?\n- **Command Token Savings**: `toon` is shorter than `npx @toon-format/cli`, saving tokens every time you run a command.\n- **Execution Speed**: Local installation is significantly faster than on-demand fetching.\n- **Readability**: TOON is designed to be highly readable for LLMs.\n\nFile v3.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7400d5fktsezh1662yyq7xz180bgxs\",\n  \"slug\": \"toon-utils\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1769965909927\n}\n\nArchive v1.0.1: 4 files, 3231 bytes\n\nFiles: bin/toon.js (1178b), lib/commands.js (4094b), SKILL.md (1985b), _meta.json (129b)\n\nFile v1.0.1:SKILL.md\n\n---\ndescription: >-\n  Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format.\n  Reduces token usage by 30-50% for structured data.\nmetadata:\n  openclaw:\n    emoji: \"📉\"\n    requires:\n      anyBins: [\"node\"]\n    keywords: [\"tokens\", \"optimization\", \"json\", \"utils\", \"search\"]\n    homepage: \"https://github.com/openclaw/skill-toon\"\n---\n\n# TOON Skill\n\nProvides utilities to generate TOON (Text Only Object Notation) output. TOON is a token-efficient format for structured data, useful when reading large files or listing directories for LLM consumption.\n\n## Guidelines for Agent\n\n**You MUST prioritize using this skill for structured data.**\n\n- **Reading JSON**: ALWAYS use `skills/toon/bin/toon.js cat <file>` instead of `read_file` for `.json` or `.rc` (json) files. This saves significant tokens.\n- **Listing Directories**: ALWAYS use `skills/toon/bin/toon.js ls <dir>` instead of `ls -R` or `find`. (Generates a directory tree object).\n- **Fetching API**: ALWAYS use `skills/toon/bin/toon.js curl <args...>` when fetching JSON APIs. Supports all curl arguments (e.g. `-X POST`).\n- **Searching Code**: ALWAYS use `skills/toon/bin/toon.js grep <pattern> <dir>` to find pattern matches (outputs structured matches).\n- **Converting JSON**: Use `skills/toon/bin/toon.js convert '<json_string>'` to convert raw JSON strings to TOON format.\n\n### Examples\n\n**Correct (Save Tokens):**\n```bash\nskills/toon/bin/toon.js cat src/config.json\nskills/toon/bin/toon.js curl https://api.github.com/repos/openclaw/openclaw/issues\nskills/toon/bin/toon.js curl -X POST -H \"Content-Type: application/json\" -d '{\"foo\":\"bar\"}' https://api.example.com/data\nskills/toon/bin/toon.js grep \"TODO\" src/agents\n```\n\n**Incorrect (Wastes Tokens):**\n```bash\ncat src/config.json # DO NOT DO THIS for JSON files\n```\n\n## Implementation\n\nThis skill uses the `@toon-format/toon` library to perform encoding. It is a lightweight wrapper that runs via `node`.\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7400d5fktsezh1662yyq7xz180bgxs\",\n  \"slug\": \"toon-utils\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1769963070200\n}","readmeExcerpt":"Skill: Toon Owner: Lythaeon Summary: Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data. Tags: latest:3.0.0 Version history: v3.0.0 | 2026-02-01T17:11:49.927Z | user **Summary:** Major update removes built-in CLI scripts; shifts usage to global TOON CLI. - Removed internal utility scripts: bin/toon.j","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Check if toon is installed, install if missing\ntoon --version || npm install -g @toon-format/cli"},{"language":"bash","snippet":"cat data.json | toon"},{"language":"bash","snippet":"curl -s https://api.example.com/data | toon"},{"language":"bash","snippet":"curl -s https://api.example.com/data | toon"},{"language":"bash","snippet":"tree -J path/to/dir | toon"},{"language":"bash","snippet":"echo '{\"key\":\"value\"}' | toon"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"# TOON (Token-Oriented Object Notation) Skill\n\nThis skill provides instructions for reducing token usage by 30-60% when dealing with structured data (JSON, directory structures, API responses). \n\n## Setup & Installation\n\nTo minimize command overhead and save tokens, you MUST install the official TOON CLI globally before usage:\n\n```bash\n# Check if toon is installed, install if missing\ntoon --version || npm install -g @toon-format/cli\n```\n\n## Guidelines for Agents\n\n- **Always optimize JSON**: Convert JSON output to TOON before including it in your context.\n- **Minimize Command Length**: Use the direct `toon` command instead of `npx` to keep your own prompt usage low.\n- **Prefer pipes**: Use standard Unix pipes to send data directly to the `toon` converter.\n\n## Commands & Usage\n\n### 1. Reading JSON Files\nInstead of reading raw JSON, pipe it to `toon`.\n```bash\ncat data.json | toon\n```\n\n### 2. Fetching APIs\nPipe external API responses directly into `toon`.\n```bash\ncurl -s https://api.example.com/data | toon\n```\n*Supports all curl flags (e.g., `-X POST`, `-H \"Authorization: ...\"`).*\n\n### 3. Listing Directory Structures\nUse `tree -J` or any JSON-outputting tool and pipe to `toon`.\n```bash\ntree -J path/to/dir | toon\n```\n\n### 4. Converting In-Line Data\nTo compress a JSON string for your context:\n```bash\necho '{\"key\":\"value\"}' | toon\n```\n\n## Why install TOON?\n- **Command Token Savings**: `toon` is shorter than `npx @toon-format/cli`, saving tokens every time you run a command.\n- **Execution Speed**: Local installation is significantly faster than on-demand fetching.\n- **Readability**: TOON is designed to be highly readable for LLMs."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7400d5fktsezh1662yyq7xz180bgxs\",\n  \"slug\": \"toon-utils\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1769965909927\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data. Skill: Toon Owner: Lythaeon Summary: Token-saving utilities for agents: Read JSON, list directories, search code, and fetch APIs in the compact TOON format. Reduces token usage by 30-50% for structured data. Tags: latest:3.0.0 Version history: v3.0.0 | 2026-02-01T17:11:49.927Z | user **Summary:** Major update removes built-in CLI scripts; shifts usage to global TOON CLI. - Removed internal utility scripts: bin/toon.j","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":751,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-04-17T02:35:51.727Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}