convert-documents-to-markdown — скилл для Claude Code: установка
Конвертирует офисные документы, электронные таблицы и PDF в GitHub-Flavored Markdown через утилиту anydoc. Пригодится, когда агенту нужно извлечь данные из DOCX или XLSX без ручной вычитки.
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a claude-codeЧто делает convert-documents-to-markdown
Скилл вызывает CLI @firecrawl/anydoc через npx без предварительной установки пакета. Формат исходника утилита определяет по содержимому: поддерживаются файлы Word, Excel, OpenDocument, а также RTF, EPUB, CSV и PDF. Если расширение отсутствует или данные идут из stdin, нужный формат задают флагом --format.
Для больших файлов предусмотрен вывод в файл ключом -o. Это защищает контекст агента от перегрузки сырыми строками. Для запуска утилиты обязательно требуется Node версии 20 или выше.
Обычные файлы CLI обрабатывает локально. На сканах или страницах с изображениями процесс завершится с кодом 3 из-за отсутствия встроенного OCR. В такой ситуации запуск с параметром --ocr hosted передаёт распознавание в облачный сервис Firecrawl Parse.
Какие задачи решает
- прочитать таблицы
.xlsxили.csvв диалоге с агентом - преобразовать документы
.docxи слайды.pptxв Markdown - выгрузить содержимое тяжёлого PDF в отдельный файл через флаг
-o - обработать сканы документов через облачный OCR с флагом
--ocr hosted
Примеры запросов агенту
- Конвертируй файл quarterly_report.xlsx в markdown и сохрани результат в report.md
- Переведи презентацию pitch.pptx в формат markdown через anydoc
- Прочитай документ specification.docx и покажи основные требования
Как установить convert-documents-to-markdown
1Через Skills CLI (Vercel)
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a claude-code2Вручную: положить файлы
~/.claude/skills/convert-documents-to-markdown/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convert-documents-to-markdown/
1Через Skills CLI (Vercel)
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a codex2Вручную: положить файлы
.agents/skills/convert-documents-to-markdown/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a cursor2Вручную: положить файлы
.cursor/skills/convert-documents-to-markdown/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install firecrawl/anydoc convert-documents-to-markdown2Вручную: положить файлы
.github/skills/convert-documents-to-markdown/SKILL.md1Через Skills CLI (Vercel)
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a gemini-cli2Командой платформы
gemini skills install https://github.com/firecrawl/anydoc --path skills/convert-documents-to-markdownВручную: положить файлы
.devin/skills/convert-documents-to-markdown/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Похожие
Вопросы о convert-documents-to-markdown
Как установить convert-documents-to-markdown в Claude Code?
Выполните команду npx skills add firecrawl/anydoc --skill convert-documents-to-markdown -a claude-code в терминале.
Что делает скилл convert-documents-to-markdown?
Он даёт агенту инструкции по запуску утилиты @firecrawl/anydoc. Инструмент переводит файлы Word, Excel, PowerPoint, OpenDocument, RTF, EPUB, CSV и PDF в разметку GitHub-Flavored Markdown.
Что делать при ошибке с кодом 3 во время обработки PDF?
Код 3 означает, что в документе есть сканированные страницы или изображения без текста. Перезапустите команду с флагом --ocr hosted, чтобы отправить файл на обработку в сервис Firecrawl Parse.
Исходный текст
SKILL.md · MIT
--- name: convert-documents-to-markdown description: Convert Word (.doc, .docx), PowerPoint (.ppt, .pptx), Excel (.xls, .xlsx), OpenDocument (.odt, .ods, .odp), RTF, EPUB, CSV, and PDF files to GitHub-Flavored Markdown. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly. license: MIT metadata: author: firecrawl --- # Convert documents to Markdown Run the anydoc CLI. It needs Node 20+ and no install: ```bash npx -y @firecrawl/anydoc <file> # Markdown to stdout npx -y @firecrawl/anydoc <file> -o out.md # write to a file npx -y @firecrawl/anydoc - --format csv < f # read stdin ``` Rules: 1. Supported inputs: `.doc`, `.docx`, `.docm`, `.odt`, `.rtf`, `.epub`, `.pdf`, `.ppt`, `.pps`, `.pot`, `.pptx`, `.pptm`, `.ppsx`, `.ppsm`, `.odp`, `.xls`, `.xlsx`, `.xlsm`, `.xlsb`, `.ods`, `.csv`. 2. The format is detected from the file content. Pass `--format <name>` only when detection cannot work: CSV from stdin, or a missing or wrong extension. 3. Exit codes: 0 success, 1 the document could not be converted, 2 usage error, 3 pages of a PDF need OCR. Failures print one `anydoc: <message>` line to stderr. The CLI never prompts. 4. For a large document, write to a file with `-o` and read the parts you need instead of streaming everything into context. 5. Scanned and image-only pages need OCR, which anydoc does not do, so the document exits 3. Rerun with `--ocr hosted` to send it to [Firecrawl Parse](https://firecrawl.dev/parse). No signup needed. Pass `--api-key` or set `FIRECRAWL_API_KEY` for higher limits. 6. Inside a Node, Python, or Rust codebase, prefer the library over shelling out: `@firecrawl/anydoc` on npm, `firecrawl-anydoc` on PyPI, `anydoc` on crates.io. Each exposes the same `to_markdown` / `toMarkdown` API.
© firecrawl · MIT · firecrawl/anydoc
