file_reader

A tool for reading and summarising local text files such as Markdown, JSON, YAML, CSV, logs, and source code. It is not intended for PDFs, Office files, images, audio, video, or archives.

In plain words
What is it for?
Use it to read or summarise local text, inspect structured data, review source code, and examine the latest part of a large log file.
Why use it?
It helps inspect text files without treating their contents as instructions or printing unnecessarily large files. It also supports basic file-type checking before reading.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tencentcloud/octop/file_reader
Any agent
npx skills add TencentCloud/Octop --skill file_reader
Clone the repo
git clone --depth 1 https://github.com/TencentCloud/Octop

Made for: Claude Code, Codex.

Per session 45 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 455 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00045 $0.00455
Opus 5 $0.00023 $0.00228
Sonnet 5 $0.00009 $0.00091
Haiku 4.5 $0.00005 $0.00046

Measured 3d ago against content hash 1921533df90e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

file_reader scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to file_reader — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

src/octop/infra/agents/experts/library/office-automation/skills/file_reader/SKILL.md · 59 lines

What it actually says

文件读取工具箱

当用户要求读取或总结本地文本文件时使用此技能。PDF、Office 文档、图片、音频和视频不在此技能范围内,应由其专用技能/工具处理。

快速类型检查

读取前先进行类型探测:

file -b --mime-type "/path/to/file"

如果文件较大,避免输出全部内容;提取小部分相关内容并进行总结。

文本文件(使用 read_file)

适用于: .txt.md.json.yaml/.yml.csv/.tsv.log.sqlinitomlpyjshtmlxml 源代码。

步骤:

  1. 使用 read_file 获取内容。
  2. 总结关键部分或展示用户请求的相关片段。
  3. 对于 JSON/YAML,列出顶层键和重要字段。
  4. 对于 CSV/TSV,展示表头和前几行,然后总结各列。

大型日志文件

如果文件很大,使用 tail 窗口:

tail -n 200 "/path/to/file.log"

总结最近的错误/警告和值得注意的模式。

超出范围

以下内容不在此技能中处理(由其他技能负责):

  • PDF
  • Office (docx/xlsx/pptx)
  • 图片
  • 音频/视频

安全与行为规范

  • 绝不执行不可信的文件。
  • 优先读取所需的最小部分。
  • 如果缺少所需工具,说明限制并请用户提供其他格式。
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 59 lines · 45 tokens per session scan A 1921533df90e

Subscribe to this mod's changes

file_reader is a skill published in the GitHub repository TencentCloud/Octop (1,292 stars, last pushed 3d ago), licensed MIT. It adds 45 tokens to every session and 455 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to file_reader, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

co-mail-and-drive

Read and send mail from the user's own Gmail or Outlook account, send from the agent's own address, manage their Outlook contacts, and list/search/download/upload their Google Drive files — with co gmail, co outlook, co email, and co gdrive. Use when the user asks about their inbox, an email they received or want to…

openonion/connectonion · 90 tokens

pptx-maker

Generate or restyle a PowerPoint deck. Use when the user wants to create or edit a .pptx presentation, build slides from text or a URL, or design a reusable slide style.

kirodotdev/KiroCrew · 43 tokens

azure-speech-to-text

Transcribe audio to text using Azure AI Speech (Fast Transcription REST API). Use when converting audio/video to text, generating subtitles, or processing spoken content in OpenMontage. Optional cloud STT provider — preferred when AZURESPEECHKEY is configured; the local faster-whisper transcriber is the default…

calesthio/OpenMontage · 74 tokens

google-docs

Google Docs via gws: read, append text, structured batch edits.

Open-Curiosity/gini-agent · 19 tokens

google-sheets

Google Sheets via gws: read/write cells, append rows, structured batch edits.

Open-Curiosity/gini-agent · 21 tokens

doc-summarizer

Summarize documents of any size: extract with the document-converter engine, chunk to fit context, fan out to subagents, then synthesize one unified summary. Handles PDF, DOCX, PPTX, XLSX, HTML, CSV, TXT, MD. Triggers: "summarize this document", "what's in this PDF", "give me a summary of these files", "extract key…

BlackBeltTechnology/pi-agent-dashboard · 105 tokens