qmd · levineam — скилл для Claude Code: поиск по markdown-заметкам
Скилл подключает агента к локальному поисковику qmd: индексирует коллекцию markdown-файлов и находит нужный документ по ключевым словам или смыслу.
npx skills add levineam/qmd-skill --skill qmd -a claude-code
npx skills add levineam/qmd-skill --skill levineam-qmd -a claude-codeЧто делает qmd
Скилл учит агента работать с утилитой qmd — локальным поисковиком по markdown-заметкам и документации. Сначала файлы добавляют в коллекцию, потом индексируют, и дальше поиск идёт по локальному индексу, без отправки заметок наружу.
Основной режим — qmd search на BM25, он отвечает мгновенно. Семантический qmd vsearch включают, когда ключевые слова не сработали: на холодном старте он может тянуться около минуты, потому что подгружает локальную модель вроде Qwen3-1.7B. Гибридный qmd query с LLM-ранжированием скилл советует пропускать — он медленнее и рискует упасть по таймауту. Результаты удобно забирать в --json или --files, а qmd get и qmd multi-get вытаскивают документ целиком.
Для работы нужны Bun не ниже 1.0.0 и сама утилита qmd, а в PATH должен быть $HOME/.bun/bin — без этого команды не найдутся. На macOS дополнительно ставят brew install sqlite ради расширений SQLite. Векторный и гибридный поиск включается один раз командой qmd embed, и её же повторяют после правок. Индекс живёт в ~/.cache/qmd/models/, путь переопределяется через XDG_CACHE_HOME. Это поиск по заметкам, а не по коду: для репозиториев нужны другие инструменты.
Какие задачи решает
- найти заметку по обрывку формулировки в своей коллекции
- подтянуть связанные документы к текущей задаче
- достать полный текст файла по результату поиска
- держать индекс markdown-заметок свежим после правок
- искать по локальным файлам, не выгружая их в облако
Примеры запросов агенту
- Найди в моих заметках всё про индексацию markdown, используй qmd search
- Достань полный текст документа из результатов через qmd get
- Обнови индекс заметок командой qmd update
Как установить qmd
1Через Skills CLI (Vercel)
npx skills add levineam/qmd-skill --skill qmd -a claude-codenpx skills add levineam/qmd-skill --skill levineam-qmd -a claude-code2Вручную: положить файлы
~/.claude/skills/levineam-qmd/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/levineam-qmd/
1Через Skills CLI (Vercel)
npx skills add levineam/qmd-skill --skill levineam-qmd -a codex2Вручную: положить файлы
.agents/skills/levineam-qmd/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add levineam/qmd-skill --skill levineam-qmd -a cursor2Вручную: положить файлы
.cursor/skills/levineam-qmd/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install levineam/qmd-skill levineam-qmd2Вручную: положить файлы
.github/skills/levineam-qmd/SKILL.md1Через Skills CLI (Vercel)
npx skills add levineam/qmd-skill --skill levineam-qmd -a gemini-cli2Командой платформы
gemini skills install https://github.com/levineam/qmd-skillВручную: положить файлы
.devin/skills/levineam-qmd/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add levineam/qmd-skill --skill levineam-qmd -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qmd
Как установить qmd в Claude Code?
Выполните npx skills add levineam/qmd-skill --skill qmd -a claude-code, затем npx skills add levineam/qmd-skill --skill levineam-qmd -a claude-code. Файл скилла окажется по пути ~/.claude/skills/levineam-qmd/SKILL.md.
Что делает qmd?
Даёт агенту доступ к локальному поисковику по markdown-заметкам и документации. Вы добавляете папку в коллекцию, индексируете её, и дальше поиск идёт по ключевым словам или по смыслу.
Чем qmd отличается от поиска по памяти агента?
qmd ищет по вашим файлам на диске, которые вы явно проиндексировали. Память агента хранит факты и контекст из прошлых сессий — это разные источники, и оба могут пригодиться.
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — qmd от других авторов.
