Agent Skills
› opensquilla/opensquilla
› text-file-read
text-file-read
GitHub读取UTF-8文本文件并原样输出内容，避免内置工具添加行号导致结构化数据损坏。适用于需人工编辑中间文件的元技能场景，支持文件大小限制和错误处理。
触发场景
需要原始文件内容供下游解析器使用
在流程中允许用户手动编辑文件
安装
npx skills add opensquilla/opensquilla --skill text-file-read -g -y
SKILL.md
Frontmatter
{
"name": "text-file-read",
"metadata": {
"opensquilla": {
"risk": "low",
"requires": {
"anyBins": [
"python",
"python3"
]
},
"capabilities": [
"filesystem-read"
]
}
},
"entrypoint": {
"args": [
"--input",
"{{ with.input }}",
"--max-bytes",
"{{ with.max_bytes | default(200000) }}"
],
"parse": "text",
"command": "python {baseDir}\/scripts\/read.py",
"timeout": 10
},
"provenance": {
"origin": "opensquilla-original",
"license": "Apache-2.0"
},
"description": "Read a UTF-8 text file and emit its raw content on stdout. Tiny helper for meta-skills that need to round-trip an artefact through disk so the user can hand-edit it between steps (e.g. tweak script.txt during a review pause). Unlike the builtin read_file tool — which returns line-numbered output for model display — this returns bytes verbatim, suitable for downstream parsers.",
"description_zh": "读取UTF-8文本文件并将其原始内容输出到stdout。为需要将产物往返磁盘以便用户在步骤间手动编辑的meta-skill提供的小工具（如评审暂停时修改script.txt）。与内置read_file工具（返回带行号的输出供模型显示）不同，本工具逐字节原样返回，适合下游解析器。"
}
text-file-read
Reads a UTF-8 text file and prints its contents verbatim to stdout (no line numbers, no decoration). Use this when a meta-skill needs to round-trip an artefact through disk between steps so the user can hand-edit the file during a clarify pause.
This skill exists alongside OpenSquilla's builtin read_file tool
on purpose: read_file is designed for LLM display and prepends a
lineno\t prefix to every line, which corrupts structured files
(scripts, SRT, YAML) when piped back into downstream parsers. This
skill returns the bytes unmodified.
Inputs (with:)
| key | required | default | notes |
|---|---|---|---|
input |
yes | — | Absolute path of the file to read. |
max_bytes |
no | 200000 |
Refuse to read files larger than this. Guards against accidental binary reads. |
Output
The file's UTF-8 content on stdout. No trailing newline added or stripped.
Failure modes
- Path missing → exit 1, stderr explains.
- File exceeds
max_bytes→ exit 1, stderr carries the actual size. - Decode error → exit 1 (file isn't valid UTF-8).
版本历史
- f662be3 当前 2026-07-31 11:50
- 7f72a32 2026-07-05 18:40
