Agent Skills
› nodetool-ai/nodetool
› sandbox-csv
sandbox-csv
GitHub提供沙箱内CSV文件的解析与生成能力，基于papaparse实现异步转换，支持自定义分隔符及表头配置。
Trigger Scenarios
需要解析CSV文本为记录对象
需要将数据记录序列化为CSV字符串
Install
npx skills add nodetool-ai/nodetool --skill sandbox-csv -g -y
SKILL.md
Frontmatter
{
"name": "sandbox-csv",
"description": "Parse and write CSV in a Code node or CodeAct action, with papaparse running on the host behind a generated facade"
}
CSV in the sandbox
Specifier: @nodetool-ai/sandbox-csv. Import it at the top of the body.
papaparse imports node:stream, so it cannot be compiled into the guest. This
pack is a host module: the import resolves to a generated facade whose two
exports call NodeTool's own implementation. Both are async — a host call is a
round trip.
parse — CSV text to records
import { parse } from "@nodetool-ai/sandbox-csv";
const rows = await parse(inputs.csv); // records keyed by the header row
const raw = await parse(inputs.csv, { header: false }); // string[][]
return { count: rows.length, first: rows[0] ?? null };
Options: header (default true), delimiter (one character; omit to
auto-detect).
Values stay strings. There is no dynamicTyping, so a column never changes
shape between runs — convert what you need with Number() or new Date().
stringify — records back to CSV
import { stringify } from "@nodetool-ai/sandbox-csv";
const csv = await stringify(inputs.rows, { delimiter: ";" });
return { csv };
Takes records or row arrays. Options: header (default true), delimiter
(exactly one character).
Gotchas
- Every export is async.
parse(...)withoutawaitgives you a Promise. - 5 MB of text per call. Input over that is refused by name. Split a bigger
file, or read it in slices with
workspace.read. - Bounded concurrency still helps. Host calls start when invoked, so
Promise.allover severalparsecalls runs them together;parallelMapis the bounded form.
Version History
- a6a7e57 Current 2026-08-20 09:52
