textbook-to-note — скилл
Конвейер переводит PDF и EPUB учебников в markdown, ищет по ним и пишет заметки Obsidian с цитатами и рисунками из книг.
- 111 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипты на Python читают ваши книги и пишут файлы в хранилище заметок
- Текст отрывков попадает в облачную модель, когда агент пишет заметку
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/textbook-to-noteОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипты на Python читают ваши книги и пишут файлы в хранилище заметок
- Текст отрывков попадает в облачную модель, когда агент пишет заметку
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Локальный конвейер из пяти стадий. Конвертер `converter/convert.py` вытаскивает текст из PDF и EPUB через PyMuPDF, ловит страницы с испорченным текстовым слоем, восстанавливает порядок колонок и отправляет в OCR только проблемные страницы. Модуль рисунков вырезает фигуры и пропускает их через проверку. Два скилла в `skills/`, `textbook-to-md` и `figure-remap`, и алгоритм из `workflows/note-writing.md` ведут агента от книги к заметке, где каждое утверждение привязано к книге и главе. Тяжелая работа идет без токенов, а дорогая модель нужна только для синтеза.
Для кого. Студенты-медики, исследователи и преподаватели с десятками справочников в PDF, которые ведут конспекты в Obsidian и хотят проверяемые заметки, а не пересказ по памяти модели.
Подходит, если
- Сорок справочников по специальности нельзя читать целиком, а нужная тема раскидана по главам
- Скан или PDF с поломанными шрифтами выдает мусор вместо текста
- Двухколоночный учебник перемешивает строки при обычном извлечении
- Заметка должна ссылаться на книгу и главу для каждого утверждения
- Нужны схемы и таблицы из книги прямо в заметке, а не их описание
Не подходит, если
- Книг пара штук, и хватит обычного чтения с поиском
- Нужно обработать чужие защищенные материалы без прав на копирование
- Семантический поиск нужен из коробки: индексатор в репозиторий не входит
Пример запроса к агенту
Сконвертируй этот PDF в markdown, найди главы про сердечную недостаточность в трех книгах и напиши заметку со ссылками на книгу и главу.Ограничения
Репозиторий не содержит индексатора: для поиска по смыслу нужен отдельный проект vault-search или совместимый CLI. Сканированные книги требуют OCR (Surya, ollama с небольшой визуальной моделью), для него лучше видеокарта NVIDIA или Apple Silicon. Протестировано на Windows 11 и macOS. Конвертировать можно только свои книги, права на копирование остаются за издателями. Последний коммит от 3 ноября 2026 года.
Как отключить. Удалите папки `textbook-to-md` и `figure-remap` из `~/.claude/skills/` и клонированный репозиторий. Сконвертированные markdown-файлы, базу поиска и заметки в хранилище очистите отдельно.
Частые вопросы
Чем различаются профили A, B и C?
A только конвертирует книги в markdown для поиска через grep. B добавляет заметки от агента с цитатами и рисунками. C подключает семантический поиск через отдельный индексатор.
Нужна ли видеокарта?
Для обычных PDF с текстовым слоем нет, достаточно процессора. Видеокарта пригодится для OCR сканированных книг.
Куда уходят мои книги?
Конвертация, OCR и эмбеддинги идут локально. Данные уходят наружу только в модель, которой вы поручаете написать заметку.
Как избежать лишнего расхода токенов?
`AGENTS.md` запрещает агенту читать книгу целиком. Страницы он ищет в готовом markdown через grep или индекс.
Где это проверено?
На Windows 11 и macOS, нужен Python 3.10 или новее. Особенности Windows, например кодировку cp950 при запуске процессов, код учитывает сам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыЗапись лекции превращается в конспект со слайдами и в HTML-страницу, где видео, расшифровка и выжимка листаются синхронно.
Навык восстанавливает PDF, презентации и сканы в Markdown по страницам, сверяя текст с картинкой страницы.
Скилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
doc-cleaner переводит PDF, Office, Keynote, Numbers и EPUB в чистый Markdown: таблицы целы, кодировки Big5 и CP950 читаются.
BookTrans переводит книгу целиком за один запуск: разведка, перевод с общим контекстом, правка, сноски и сборка в epub или fb2.
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| textbook-to-note (эта карточка) | нет | 111 | ||
| Obsidian Knowledge Agent | нет | 206 | раскладывает PDF, слайды и ссылки по заметкам; здесь конвертер учебников с проверкой колонок, OCR и рисунков | |
| pdf-mcp | нет | не нужна | 171 | MCP ищет и читает нужные страницы PDF по запросу; здесь автономный конвейер с готовым markdown и заметками с цитатами |
Коротко о README
Проект построен на правилах: тяжелая работа без токенов, жесткие проверки вместо оценки на глаз и ссылка на книгу для каждого утверждения. Автор ведет заметки по медицине с учебы.