TOON（Token-Oriented Object Notation）是一种为 LLM 提示设计的紧凑、人类可读的序列化格式。该技能提供在 Claude Code 中使用 TOON 的规则。官方说明其相比 JSON 在均匀表格数据上约节省 50% token，并引用 TOON GitHub 与 TOON Spec v1.3。
适用场景：字段相同、仅含基本类型的均匀对象数组；结构一致的大型数据集；重视 token 效率的 LLM 输入输出；数据由 LLM 消费而非 API 或存储。不适用场景：非均匀结构、混合类型、字段各异的对象、深层嵌套对象、API 响应、需要 JSON 兼容的存储格式。
语法要点：嵌套使用 2 空格缩进；数组头标注数量如 items[2]；表格数组带字段名如 items[2]{id,qty,price}:；基本对象直接以 key: value 书写；基本类型数组可内联如 tags[2]: reading,gaming；非均匀数据用列表格式以 - 开头。可选自定义分隔符（如大表格用竖线或制表符）和长度标记 hash 前缀如 tags[#3]。
在 Claude Code 中的用法：作为输入时用 ```toon 代码块包裹并保留显式长度标记，格式本身自解释；要求 Claude 输出 TOON 时，需给出期望的表头（如 users[N]{id,name,role}:）、显式规则（2 空格缩进、[N] 与实际行数一致、无尾随空格）并提供模板。该技能提到可与 Claude Projects 和 Artifacts、子代理、Hooks 配合使用，作为结构化数据格式。
限制与说明：TOON 不是 JSON 的通用替代品，仅用于 LLM 提示；基准使用 GPT 风格分词器，实际节省可能不同；制表符可进一步节省 token 但在部分编辑器中有显示问题；需参考 TOON 规范处理边界情况与完整语法。技能还包含强制记忆协议，要求在开始前读取 .claude/context/memory/learnings.md，完成后记录新发现的模式或例外。