file-conversion — плагин для Claude Code: конвертация файлов
Плагин помогает конвертировать локальные изображения, аудио, видео, документы и таблицы установленными на компьютере инструментами. Оригинал остаётся на месте.
/plugin marketplace add wshobson/agents
/plugin install file-conversion@claude-code-workflowsЧто делает file-conversion
Агент проверяет доступные локальные программы, изучает файл и выбирает подходящий способ конвертации. Результат сохраняется в новой папке, исходник не заменяется. Можно задать целевой формат и требования к качеству или вёрстке; для URL сначала нужен доступный способ получить файл.
Для аудио и видео нужны FFmpeg и FFprobe, для изображений — ImageMagick 7, для документов — Pandoc или LibreOffice, для CSV и JSON — Python 3. Плагин даёт инструкции, а не устанавливает эти программы. PDF в Word не гарантирован, а для сканированного PDF понадобятся локальные OCR-инструменты и отдельная проверка вёрстки. Без нужных кодеков, шрифтов или места на диске маршрут конвертации может не сработать.
Преобразование проходит на локальных копиях и не загружает файлы в сервис конвертации. Для документов с внешними ссылками или макросами требуется среда с заблокированной сетью и отключёнными макросами; одного временного профиля недостаточно. На Windows могут отличаться имена программ и синтаксис команд оболочки.
Какие задачи решает
- перевести изображение в другой формат
- конвертировать аудио или видео локальными программами
- экспортировать офисный документ в PDF
- преобразовать данные между CSV и JSON
- сохранить исходник при конвертации файла
Примеры запросов агенту
- Преобразуй
report.docxв PDF и сохрани результат отдельно от оригинала. - Конвертируй
clip.movв MP4 с учётом требований к качеству. - Переведи
records.csvв JSON, не изменяя исходный файл.
Как установить file-conversion
Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install file-conversion@claude-code-workflowsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о file-conversion
Как установить file-conversion в Claude Code?
Выполните команды по порядку: /plugin marketplace add wshobson/agents, затем /plugin install file-conversion@claude-code-workflows.
Что делает file-conversion?
Помогает выбрать локальный инструмент для конвертации изображений, аудио, видео, документов и табличных данных. Результат записывается в новую папку, оригинал сохраняется.
Какие программы нужны для работы file-conversion?
Зависит от задачи: для аудио и видео нужны FFmpeg и FFprobe, для изображений — ImageMagick 7, для документов — Pandoc или LibreOffice, для CSV и JSON — Python 3.
Исходный текст
file-conversion · MIT
# File conversion Guidance for converting local files with installed tools, preserving originals, and checking the results. The workflow uses local files and local output paths. It does not call hosted conversion services or upload files. ## Prerequisites Install only the tools required for the requested route, under the session's existing permission policy: - FFmpeg and FFprobe for audio/video; available codecs depend on the build. - ImageMagick 7 (`magick`) for images; formats such as HEIC and PDF may need delegates or a compatible local policy. - Pandoc for supported structured document formats such as Markdown and DOCX. - LibreOffice (`soffice`) for supported office-document exports, including PDF. - Python 3 for CSV/JSON data conversion using the standard library. The plugin supplies guidance, not these executables. The agent checks what is already installed, inspects the source, and chooses a supported route. On Windows, executable names and shell syntax may differ. No account or API key is required. ## Use and limits Provide a local file or a retrievable URL, the target format, and any quality or layout requirements. Results go into a fresh directory without replacing the original. The skill includes examples and checks for media, images, documents, and tabular data. Support depends on the installed readers, writers, codecs, fonts, and available memory and disk space. Conversion may change layout, color, transparency, or compression. PDF-to-Word is not guaranteed; scanned PDFs require local OCR tools and a separate layout review. Unsupported routes stop with an explanation. URL inputs can first be retrieved through an already-authorized method; report an access gap if retrieval is unavailable. Conversion runs on local copies and local assets. For documents with external links or macros, use an environment with network access blocked and macros disabled, or stop. A temporary profile alone provides neither control. ## Migration from version 1 Version 2.0 removes the ChangeThisFile service integration and the bundled `skills/file-conversion/scripts/convert.sh` upload script. Existing calls to that script must be replaced with the appropriate local tool; there is no drop-in script replacement. The plugin and skill names remain `file-conversion`. Aadil Razvi authored the original hosted-service integration. Repository maintainers rewrote version 2.0 for local tools and maintain the current workflow.
© Seth Hobson · MIT · wshobson/agents
