file-data-ops
Read, transform and organize workspace files and structured data safely
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 12
- Forks
- 2
01 前言 Front Matter
- name
- file-data-ops
- license
- MIT
- metadata
- { "polyrob-when": "Reading, converting or organizing local files and data", "polyrob-version": "2", "polyrob-priority": "3", "polyrob-triggers": "{\"tool_ids\":[\"filesystem\"]}" }
- description
- Read, transform and organize workspace files and structured data safely
03 SKILL.md 正文
File & Data Ops
Read, transform, and organize workspace files and structured data safely. Recommended
workflow — adapt as needed. Uses the filesystem tool when your <tool-catalog> holds
it (a group room does not); without it, say that you cannot open files here.
When to use
Reading or parsing files, working with CSV/JSON/JSONL/Markdown/text, reading a PDF or
Word file, extracting or converting data, or organizing files in the workspace. For a
computed answer from a dataset (totals, groupings, a chart), use data-analysis.
Workflow
- Inspect before you change anything.
filesystem_list_directory, thenfilesystem_read_filewithlimit(lines) orchar_limit(dense JSON) for a sample. - Tabular data: read the header and a few rows to learn the schema first.
- Large files: do not read 100k+ tokens into context. Find the region with
coding_grepwhencodingis loaded; else read in windows (offset/limit,char_offset/char_limit). A whole-file read over the cap returns the TAIL and says so. - Documents:
.pdf/.docx—filesystem_read_filereturns the extracted text; page it withoffset/limit. A scanned PDF has no text layer: the result says so..xlsx/.xls/.doc/.pptx—filesystem_read_filecannot decode them. Use a script throughcode_execution(openpyxlfor a spreadsheet) when it is loaded; else say that you cannot read the file and ask for a CSV or PDF.- A file the owner will ask about again:
knowledge_kb_ingest(path=…), thenknowledge_kb_search.
- JSON-lines: add with
filesystem_jsonl_append, remove withfilesystem_jsonl_remove, check withfilesystem_jsonl_validate. Never rewrite the file by hand or with a pretty-printed object. - Do not clobber the source.
filesystem_copy_fileit first, or write the result to a NEW file. Make transforms idempotent. - Validate the output after writing: row/field counts, the expected schema.
- Report and deliver. Say what changed. Deliver the result file: put its ABSOLUTE
workspace path in your
send_messagetext (the framework attaches it or links it; the result says which). Usemessage(media_paths=[…])only to send it to another chat.
Notes
- Write file content verbatim — never reflow or strip indentation (it corrupts code, YAML, and indentation-sensitive formats).
- A Markdown file from an earlier session is a record: see
document-writingbefore you rewrite one.
04 同仓库更多 Skills
echo-basics
How to use the echo tool from the echo fixture pack.
x-engagement
Operate X account communication on the API rail (the captured-browser rail only where the owner chose it)—read inboxes, post/reply, send DMs, set up the account, with the real write gates and completion evidence
social-discovery
Discover public X/social accounts and conversations with AnySite first (anysite_describe, then anysite_api), using native X account reads where they are authoritative and preserving write gates
polymarket-trading
GATED: place/cancel Polymarket orders. Owner-only, read-first, >$500 confirmation gate; references crypto-trading-safety
polymarket-portfolio-review
Read the configured Polymarket account's positions and trade history from the public Data API (no address parameter); summarize exposure and P&L
polymarket-market-research
Read Polymarket markets (discover, details, price as implied probability, orderbook, spread, volume) with no wallet