file-reading — скилл для Claude Code: чтение загруженных файлов
Скилл-маршрутизатор: подсказывает агенту, каким инструментом открыть загруженный файл — PDF, DOCX, XLSX, CSV, JSON, картинку или архив.
npx skills add SeifBenayed/cloclo --skill file-reading -a claude-codeЧто делает file-reading
Когда файл загружен, но его содержимого в контексте нет — есть только путь в /mnt/user-data/uploads/ — агент часто лезет читать его вслепую. На PDF это даёт бинарный мусор, на большом CSV забивает контекст строками, на DOCX печатает ZIP-байты. Скилл закрывает эту дыру: по расширению файла он говорит, с чего начать.
Внутри — таблица соответствий «расширение → первый шаг → профильный скилл». Для PDF это pdfinfo и pdftotext, для DOCX — pandoc в markdown, для таблиц — openpyxl с read_only=True или pandas с nrows, для JSON — jq, для архивов — сначала список содержимого без распаковки. Общий протокол советует сначала посмотреть на расширение, потом сделать stat и file, а читать ровно столько, сколько нужно для ответа на вопрос.
Легаси-форматы требуют обходных путей: .doc и .ppt сначала конвертируются, .xls открывается через engine="xlrd", .ods — через engine="odf", потому что openpyxl их не принимает. Скилл не работает, если содержимое файла уже видно в контексте в блоке documents — тогда читать нечего.
Какие задачи решает
- открыть загруженный PDF, не получив бинарный мусор в выводе
- посмотреть структуру большого CSV, не выгружая его целиком
- прочитать DOCX как markdown через pandoc
- узнать имена листов в XLSX до выгрузки данных
- разобрать JSON-файл по структуре, а не целиком
Примеры запросов агенту
- Посмотри файл
/mnt/user-data/uploads/report.pdfи скажи, сколько в нём страниц - Что за структура у
/mnt/user-data/uploads/data.json? - Открой
/mnt/user-data/uploads/memo.docxи перескажи первые абзацы
Как установить file-reading
1Через Skills CLI (Vercel)
npx skills add SeifBenayed/cloclo --skill file-reading -a claude-code2Вручную: положить файлы
~/.claude/skills/file-reading/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/file-reading/
1Через Skills CLI (Vercel)
npx skills add SeifBenayed/cloclo --skill file-reading -a codex2Вручную: положить файлы
.agents/skills/file-reading/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add SeifBenayed/cloclo --skill file-reading -a cursor2Вручную: положить файлы
.cursor/skills/file-reading/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install SeifBenayed/cloclo file-reading2Вручную: положить файлы
.github/skills/file-reading/SKILL.md1Через Skills CLI (Vercel)
npx skills add SeifBenayed/cloclo --skill file-reading -a gemini-cli2Командой платформы
gemini skills install https://github.com/SeifBenayed/cloclo --path .claude/skills/file-readingВручную: положить файлы
.devin/skills/file-reading/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add SeifBenayed/cloclo --skill file-reading -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о file-reading
Как установить file-reading в Claude Code?
Выполните npx skills add SeifBenayed/cloclo --skill file-reading -a claude-code. После этого скилл окажется в ~/.claude/skills/file-reading/SKILL.md.
Что делает file-reading?
Это маршрутизатор по типам файлов. Он подсказывает агенту, каким инструментом открыть загруженный файл, чтобы не запускать cat по бинарнику и не тянуть в контекст лишнее.
Когда file-reading не нужен?
Если содержимое файла уже видно в контексте в блоке documents, читать нечего — скилл в этом случае не применяется.
