Agent Skills › ymx10086/ResearchClaw › file-reader

file-reader

GitHub

用于读取、预览和总结本地文本文件（如代码、配置、日志等）。支持类型检测、大文件截取及内容摘要，排除多媒体文件。

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.