# file-reading

Скилл-маршрутизатор: подсказывает агенту, каким инструментом открыть загруженный файл — PDF, DOCX, XLSX, CSV, JSON, картинку или архив.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 116
- Автор: SeifBenayed
- Лицензия: LicenseRef-Proprietary · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/SeifBenayed/cloclo/tree/HEAD/.claude/skills/file-reading/SKILL.md
- Обновлён: 2026-04-05
- HTML: https://affpapa.org/nevibecode/skills/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 — тогда читать нечего.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SeifBenayed/cloclo --skill file-reading -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/file-reading/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/file-reading/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SeifBenayed/cloclo --skill file-reading -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/file-reading/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SeifBenayed/cloclo --skill file-reading -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/file-reading/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SeifBenayed/cloclo file-reading
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/file-reading/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SeifBenayed/cloclo --skill file-reading -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/SeifBenayed/cloclo --path .claude/skills/file-reading
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/file-reading/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add SeifBenayed/cloclo --skill file-reading -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/SeifBenayed/cloclo/tree/HEAD/.claude/skills/file-reading/SKILL.md

## Когда брать
- открыть загруженный 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` и перескажи первые абзацы

## Похожие
- [shuck-file](https://affpapa.org/nevibecode/mcp/shuck-file.md) — MCP-сервер · ★ 6
- [convert-documents-to-markdown](https://affpapa.org/nevibecode/skills/convert-documents-to-markdown.md) — скилл · 12600 установок
- [PDF Converter](https://affpapa.org/nevibecode/skills/pdf-converter.md) — скилл · 5200 установок
- [convert-to-md](https://affpapa.org/nevibecode/plugins/convert-to-md.md) — плагин · ★ 40451
- [office-oxide-mcp](https://affpapa.org/nevibecode/mcp/office-oxide-mcp.md) — MCP-сервер · ★ 162
- [document-converter-suite](https://affpapa.org/nevibecode/skills/document-converter-suite.md) — скилл · 483 установки

Из того же набора: [seifbenayed/cloclo](https://affpapa.org/nevibecode/by/seifbenayed/cloclo.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md