AI agent skill · by @TokenRhythm

Text File Read

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.

Archived 2026-10-23 · Source updated 2026-09-17 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# 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).