memory-metadata-search · basicmachines-co — скилл для Claude Code
Скилл для Basic Memory: ищет заметки по полям frontmatter — статусу, приоритету, уверенности — вместо свободного текста.
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a claude-codeЧто делает memory-metadata-search
Заметки в Basic Memory хранят структуру в YAML-frontmatter. Любой ваш ключ помимо стандартных (title, type, tags, permalink, schema) попадает в индекс entity_metadata и становится доступен для запроса. Скилл объясняет агенту, как строить такие запросы через search_notes.
Фильтры передаются словарём JSON в metadata_filters. Есть равенство, вхождение в список через $in, сравнения $gt, $gte, $lt, $lte, диапазон $between и вложенные поля через точку — например {"schema.version": "2"}. Несколько ключей складываются по «И». Для tags и status есть короткие параметры. Текстовый поиск можно сузить метаданными или вовсе обойтись без запроса.
Операторы пишутся с префиксом $. Без него фильтр считается точным совпадением ключа и молча вернёт пусто: {"confidence": {"gte": 0.7}} не сработает, нужно $gte. Ключи подчиняются шаблону [A-Za-z0-9_-]+, в операторном словаре ровно один оператор, а $between принимает строго пару [min, max].
Какие задачи решает
- найти все заметки со статусом
draft - отобрать спеки с приоритетом
highилиcritical - выбрать заметки с уверенностью выше порога
- сузить текстовый поиск по полю frontmatter
- отфильтровать заметки по вложенному полю схемы
Примеры запросов агенту
- Найди заметки с
status: in-progressи типомspec - Покажи заметки, где
confidenceбольше 0.7 - Найди заметки с тегом
securityи статусомdraft
Как установить memory-metadata-search
1Через Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a claude-code2Вручную: положить файлы
~/.claude/skills/memory-metadata-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/memory-metadata-search/
1Через Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a codex2Вручную: положить файлы
.agents/skills/memory-metadata-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a cursor2Вручную: положить файлы
.cursor/skills/memory-metadata-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install basicmachines-co/basic-memory-skills memory-metadata-search2Вручную: положить файлы
.github/skills/memory-metadata-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/basicmachines-co/basic-memory-skills --path memory-metadata-searchВручную: положить файлы
.devin/skills/memory-metadata-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о memory-metadata-search
Как установить memory-metadata-search в Claude Code?
Выполните npx skills add basicmachines-co/basic-memory-skills --skill memory-metadata-search -a claude-code. Файл скилла появится по пути ~/.claude/skills/memory-metadata-search/SKILL.md.
Что делает memory-metadata-search?
Учит агента искать заметки Basic Memory по полям frontmatter: равенство, диапазоны, вхождение в список, вложенные ключи. Работает через search_notes с параметром metadata_filters.
Чем метаданные-поиск отличается от обычного текстового?
Текстовый ищет по содержанию, метаданные — по известному значению поля. Их можно совмещать: текстовый запрос плюс фильтр по статусу или приоритету.
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — memory-metadata-search от других авторов.