AI и агенты
Tutor Skills
bevibing/tutor-skillsДва Claude Code скилла: первый генерирует структурированное хранилище Obsidian из PDF, кода и документов, второй проводит интерактивные квизы с отслеживанием прогресса по концепциям.
Установка
terminal
bash
npx skills add RoundTable02/tutor-skillsREADME
tutor-skill
Два скилла Claude Code, которые превращают любой источник знаний в Obsidian StudyVault и затем проверяют ваши знания — замыкая цикл от контента до понимания.
Как это работает
Документы / Код Obsidian Сессия квиза
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ PDF, MD, HTML, │ /tutor │ StudyVault/ │ /tutor │ 4 вопроса за │
│ EPUB, исходный │──setup──▶ │ структурир. │────────▶ │ раунд, оценка, │
│ код проектов │ │ связанные │ │ отслеживание │
└──────────────────┘ │ заметки + MOC │ └────────┬─────────┘
└──────────────────┘ │
▲ │
└──── обновления прогресса ───┘
Обзор скиллов
| Скилл | Команда | Назначение | Входные данные | Результат |
|---|---|---|---|---|
| tutor-setup | /tutor-setup | Генерация StudyVault | Документы или исходный код | Хранилище Obsidian с заметками, дашбордами, практическими вопросами |
| tutor | /tutor | Интерактивный квиз-тьютор | Существующий StudyVault | Сессии квизов с отслеживанием прогресса по концепциям |
Быстрый старт
Установка в одну строку (рекомендуется)
npx skills add RoundTable02/tutor-skills
Требует npx skills — работает с Claude Code, Cursor, Windsurf и другими инструментами.
Ручная установка
bash
git clone https://github.com/RoundTable02/tutor-skills.git
cd tutor-skills
./install.shШаг 1: Генерация StudyVault
bash
cd ~/study-materials/ # или любой проект с исходным кодом
claude
> /tutor-setupШаг 2: Начало квиза
bash
claude
> /tutortutor-setup
Преобразует источники знаний в структурированный Obsidian StudyVault. Режим определяется автоматически:
| Найденный маркер | Режим |
|---|---|
package.json, pom.xml, build.gradle, Cargo.toml, go.mod и др. | Режим кодовой базы |
| Маркеры проекта отсутствуют | Режим документов |
Режим документов
Превращает PDF, текстовые файлы, веб-страницы и другие источники в подробные учебные заметки.
- Автоматически сканирует рабочую директорию на наличие исходных файлов (PDF, TXT, MD, HTML, EPUB)
- Извлекает и анализирует контент с верифицированным маппингом источников
- Генерирует концептуальные заметки со сравнительными таблицами, ASCII-диаграммами и паттернами для экзаменов
- Создаёт практические вопросы со скрытыми ответами (активное воспроизведение через fold callouts)
- Строит дашборд с картой контента (MOC), быстрым справочником и типичными ловушками на экзаменах
- Полное перекрёстное связывание через
[[wiki-links]]по всем заметкам
Фазы
| Фаза | Название | Описание |
|---|---|---|
| D1 | Обнаружение источников | Сканирование, извлечение и верификация маппинга контента |
| D2 | Анализ контента | Построение иерархии тем и карты зависимостей |
| D3 | Стандарт тегов | Определение реестра тегов в формате kebab-case на английском |
| D4 | Структура хранилища | Создание пронумерованных папок по темам |
| D5 | Дашборд | MOC, быстрый справочник, ловушки на экзаменах |
| D6 | Концептуальные заметки | Структурированные заметки с таблицами, диаграммами, callouts |
| D7 | Практические вопросы | Активное воспроизведение через fold callouts (8+ на тему) |
| D8 | Перекрёстные ссылки | Связывание всех заметок через wiki-links |
| D9 | Самопроверка | Верификация по чеклисту качества |
Генерируемая структура
StudyVault/
00-Dashboard/ # MOC + быстрый справочник + ловушки на экзаменах
01-<Тема1>/ # Концептуальные заметки + практические вопросы
02-<Тема2>/
...
Режим кодовой базы
Генерирует хранилище для онбординга новых разработчиков из проекта с исходным кодом.
- Автоматически определяет технологический стек, архитектурные паттерны и границы модулей
- Трассирует потоки запросов и потоки данных от начала до конца
- Создаёт заметки по каждому модулю с ключевыми файлами, публичными интерфейсами и картами зависимостей
- Генерирует упражнения для онбординга (чтение кода, конфигурация, отладка, расширение)
- Строит дашборд с обзором архитектуры, картой модулей, поверхностью API и руководством по началу работы
Фазы
| Фаза | Название | Описание |
|---|---|---|
| C1 | Исследование проекта | Сканирование файлов, определение стека, маппинг структуры |
| C2 | Анализ архитектуры | Выявление паттернов, трассировка потоков, маппинг модулей |
| C3 | Стандарт тегов | Определение реестра #arch-*, #module-*, #pattern-* |
| C4 | Структура хранилища | Создание дашборда и папок по модулям |
| C5 | Дашборд | MOC с картой модулей, поверхностью API, руководством по старту |
| C6 | Заметки по модулям | Назначение, ключевые файлы, интерфейс, поток, зависимости |
| C7 | Упражнения | Чтение кода, конфигурация, отладка, задачи на расширение |
| C8 | Перекрёстные ссылки | Связывание всех модулей и упражнений |
| C9 | Самопроверка | Верификация по чеклисту качества |
Генерируемая структура
StudyVault/
00-Dashboard/ # MOC + быстрый справочник + руководство по старту
01-Architecture/ # Обзор системы, поток запросов, поток данных
02-<Модуль1>/ # Заметки по модулям
03-<Модуль2>/
...
NN-DevOps/ # Сборка, деплой, CI/CD
NN+1-Exercises/ # Упражнения для онбординга
tutor
Интерактивный квиз-тьютор, который отслеживает, что вы знаете и не знаете, на уровне концепций. Работает с любым StudyVault, сгенерированным через tutor-setup.
Типы сессий
| Тип | Доступность | Фокус |
|---|---|---|
| Диагностика | Есть неизмеренные области (⬜) | Широкая оценка новых областей |
| Проработка слабых мест | Есть слабые области (🟥/🟨) | Целенаправленная практика по проблемным темам |
| Выбор раздела | Всегда | Изучение любой области по запросу |
| Режим сложности | Все области 🟩/🟦 | Проверка освоенного материала |
Процесс квиза
- Определяет ваш StudyVault и загружает карту прогресса
- Предлагает тип сессии на основе текущего состояния прогресса
- Задаёт 4 вопроса за раунд с немедленной обратной связью
- Обновляет прогресс по концепциям после каждого раунда
- Предлагает продолжить или завершить сессию