convert
Skill9 starsChanged 6 months agoMITView on GitHub
[STATUS: review] [CONFIDENCE: high] [REVIEWED: 2026-06-01] Конвертирует PDF/DOCX/PPTX/XLSX/HTML/audio/YouTube/изображения в Markdown через Microsoft markitdown. Экономит 5-10x токенов на больших документах перед чтением Claude. Сохраняет результат рядом с исходником (file.pdf → file.md). Идемпотентен. Triggers: /convert, конвертируй документ, преврати в markdown, "pdf в markdown", "docx в markdown", convert to markdown, "сделай markdown из", markitdown, "переведи документ", "обработай PDF". Используй когда у тебя есть документ любого формата и хочешь работать с ним в Claude без лишних токенов. НЕ для: уже markdown-файлов, очень больших PDF (>100MB — split first).
- Installs packages
8 other projects use a version of this.
Adopted by
Most recently taken up by
- linxule/carreltheir own version, first seen Nov 8, 2026
- conversiontools/agent-skillstheir own version, first seen Nov 7, 2026
- Anglesite/anglesite-skillstheir own version, first seen Oct 27, 2026
- SmailG/plc-programmingtheir own version, first seen Oct 15, 2026
- remotion-dev/remotiontheir own version, first seen Oct 8, 2026
- theYahia/cbr-mcptheir own version, first seen Jun 23, 2026
Other versions8 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 8
- remotion-dev/remotion★ 72ksame name
- ArvorCo/Relentless★ 98same name
- Kucoin/kucoin-skills-hub★ 28same name
- Anglesite/anglesite-skills★ 15same name
- conversiontools/agent-skills★ 8same name
- linxule/carrel★ 2same name
- theYahia/cbr-mcp★ 1same name
- SmailG/plc-programming★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository164 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .codex/AGENTS.mdAGENTS.md
- agents/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- claude-md/CLAUDE.mdCLAUDE.md
- hooks/CLAUDE.mdCLAUDE.md
- insight-architectSkill
- agent-teamsSkill
- brainstormingSkill
- claim-decomposerSkill
- context-engineeringSkill
- dispatcherSkill
- git-worktreesSkill
- hd-mavp-routerSkill
- mentor-modeSkill
- reference-registrySkill
- routing-policySkill
- skill-self-updateSkill
- tdd-workflowSkill
- ab-testSkill
- academic-researchSkill
- advanced-methodology-extensionsSkill
- agent-governanceSkill
- ai-hyp-gateSkill
- algorithm-designSkill
- analystSkill
- archcode-genomicsSkill
- arm-cortex-microcontrollersSkill
- atomizeSkill
- backward-traceabilitySkill
- boyko-constraint-engineSkill
- boyko-epistemic-auditSkill
- boyko-goal-expansion-100Skill
- boyko-knowledge-architectureSkill
- boyko-leverage-mapSkill
- boyko-methodSkill
- boyko-preflightSkill
- boyko-project-radarSkill
- boyko-rippleSkill
- boyko-scientific-consortiumSkill
- boyko-specialistSkill
- boyko-toolcheckSkill
- boyko-triangle-auditSkill
- boyko-why-ladderSkill
- browser-actSkill
- build-autoSkill
- c4-architectureSkill
- career-prepSkill
- changelog-genSkill
- citation-managementSkill
- code-debuggingSkill
- code-materialitySkill
- codex-skepticSkill
- codex-solverSkill
- codex-tracySkill
- combinatorial-creativitySkill
- common-groundSkill
- conductorSkill
- consilienceSkill
- construct-measurement-gateSkill
- The first 60 shown.
The file
Files
<!-- BSV — Brief Skill View | поиск: BSV
Скил : convert
TL;DR : PDF/DOCX/PPTX/audio/YouTube → Markdown через MS markitdown. Экономия 5-10x токенов
Вызов : /convert <file_or_url>, конвертируй документ
НЕ для : Уже markdown файлов, очень больших PDF (split first)
-->/convert — Document → Markdown
Конвертирует документ в Markdown через Microsoft markitdown. Локально, бесплатно, ~18 converters.
Поддерживаемые форматы
| Категория | Расширения |
| Документы | .pdf, .docx, .doc, .rtf, .odt |
| Презентации | .pptx, .ppt, .odp |
| Таблицы | .xlsx, .xls, .csv, .tsv, .ods |
| Веб | .html, .htm, YouTube URL |
.msg (Outlook) | |
| Книги | .epub |
| Данные | .json, .xml |
| Архивы | .zip (рекурсивно) |
Аудио (если установлен markitdown[audio]) | .mp3, .wav |
Изображения (если установлен markitdown[ocr]) | .png, .jpg |
Установка
# Минимум:
pip install markitdown
# С audio + OCR + всеми converters:
pip install markitdown[all]Использование
Вариант 1: CLI напрямую
markitdown paper.pdf > paper.md
markitdown report.docx > report.md
markitdown https://www.youtube.com/watch?v=XXX > transcript.mdВариант 2: Через этот skill
Скажи в чате одно из:
/convert paper.pdfконвертируй report.docxпреврати https://youtube.com/watch?v=... в markdown
Я:
- Найду исходный файл
- Запущу markitdown
- Сохраню
paper.mdрядом сpaper.pdf - Покажу превью результата
Когда применять
| Ситуация | Действие |
| Скачал PDF научной статьи | /convert paper.pdf → дальше Claude работает с .md |
| Получил DOCX с отчётом | /convert report.docx |
| Хочешь обработать YouTube лекцию | /convert https://youtu.be/... |
| Excel с данными | /convert data.xlsx → table в md format |
Экономия токенов (примерные оценки)
| Формат | Прямой | После markitdown | Saving |
| 20-стр PDF научной статьи | ~50K tokens | ~5-8K tokens | 6-10x |
| 50-стр DOCX доклад | ~100K tokens | ~15K tokens | 6-7x |
| Excel 10 sheets | ~30K tokens | ~5K tokens | 6x |
| YouTube 30 min | (нет vision) | ~3-5K tokens | enable read |
Companion skills
/defuddle— web страницы (HTML с шумом), если установлен
Ограничения
| Lim | Что | Mitigation |
| Сложные таблицы PDF | Структура может теряться | Использовать Docling для critical tables |
| Математические формулы | LaTeX рендеринг хромает | Manual review для math-heavy |
| Scanned PDF (image-only) | Нужен OCR | pip install markitdown[ocr] |
| Audio transcription | Медленно (~1x realtime) | Запускать в фоне |
| >100MB файлы | Slow / OOM | Split tool first |
Output format
Markdown файл сохраняется рядом с исходником:
paper.pdf→paper.mdreport.docx→report.md
Файл начинается с auto-generated header:
<!-- Auto-converted from <name> by markitdown -->Reference
- GitHub: github.com/microsoft/markitdown
- License: MIT
- Maintainer: Microsoft AutoGen team
- Sister tools: defuddle (web), Docling (IBM, complex layout)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.