Agent Skills › ymx10086/ResearchClaw › file-reader

file-reader

GitHub

用于读取、预览和总结本地文本文件（如代码、配置、日志等）。支持类型检测、大文件分块读取及摘要生成，明确排除PDF等多媒体格式，确保仅处理纯文本数据。

src/researchclaw/agents/skills/file_reader/SKILL.md ymx10086/ResearchClaw

Trigger Scenarios

用户请求读取或查看本地文件内容用户需要总结配置文件或源代码结构用户要求分析大型日志文件的关键错误

Install

npx skills add ymx10086/ResearchClaw --skill file-reader -g -y

More Options

Non-standard path

npx skills add https://github.com/ymx10086/ResearchClaw/tree/main/src/researchclaw/agents/skills/file_reader -g -y

Use without installing

npx skills use ymx10086/ResearchClaw@file-reader

指定 Agent (Claude Code)

npx skills add ymx10086/ResearchClaw --skill file-reader -a claude-code -g -y

安装 repo 全部 skill

npx skills add ymx10086/ResearchClaw --all -g -y

预览 repo 内 skill

npx skills add ymx10086/ResearchClaw --list

SKILL.md

Frontmatter

{
    "name": "file-reader",
    "emoji": "📄",
    "requires": [],
    "description": "Read, preview, and summarize text-based files — source code, configs, logs, data files, and plain text documents. Use when the user asks to read, inspect, or summarize local .txt, .md, .json, .yaml, .csv, .log, or source code files."
}

File Reader Toolbox

Use this skill when the user asks to read or summarize local text-based files. PDFs, Office documents, images, audio, and video are out of scope for this skill and should be handled by their dedicated skills/tools.

Quick Type Check

Use a type probe before reading:

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

If the file is large, avoid dumping the whole content; extract a small, relevant portion and summarize.

Text-Based Files (use read_file)

Preferred for: .txt, .md, .json, .yaml/.yml, .csv/.tsv, .log, .sql, ini, toml, py, js, html, xml source code.

Steps:

Use read_file to fetch content.
Summarize key sections or show the relevant slice requested by the user.
For JSON/YAML, list top-level keys and important fields.
For CSV/TSV, show header + first few rows, then summarize columns.

Large Logs

If the file is huge, use a tail window:

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

Summarize the last errors/warnings and notable patterns.

Out of Scope

Do not handle the following in this skill (they are covered by other skills):

PDF
Office (docx/xlsx/pptx)
Images
Audio/Video

Safety and Behavior

Never execute untrusted files.
Prefer reading the smallest portion necessary.
If a tool is missing, explain the limitation and ask the user for an alternate format.