metadata-agent — субагент для Claude Code: что делает и как установить
Субагент приводит к единому стандарту frontmatter в заметках Obsidian. Он находит файлы без метаданных, проставляет типы, теги и даты создания.
npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agentЧто делает metadata-agent
Агент проверяет markdown-документы в хранилище Obsidian и добавляет шапку frontmatter туда, где её нет. В метаданные попадают поля tags, type, created, modified и status. Субагент определяет дату создания из файловой системы, а теги собирает по расположению файла и его содержимому. Тип заметки выбирается из списка: note, reference, moc, daily-note, template или system.
Для работы используется Python-скрипт metadata_adder.py, который запускается через инструмент Bash. Сначала выполняется проверка с ключом --dry-run, чтобы увидеть планируемые правки без записи на диск. Субагент сохраняет уже существующие метаданные и правит frontmatter только при обнаружении явных ошибок.
В исходных инструкциях пути к скрипту и правилам жёстко привязаны к каталогу /Users/cam/VAULT01/System_Files/, поэтому под своё хранилище пути в шаблоне придётся поправить.
Какие задачи решает
- добавить недостающие блоки frontmatter в markdown-файлы хранилища
- заполнить дату создания заметки по времени из файловой системы
- назначить иерархические теги на основе папки и текста
- присвоить статус и категорию документа для базы знаний
Примеры запросов агенту
- Проверь хранилище через субагента metadata-agent и покажи файлы без frontmatter
- Запусти metadata-agent с флагом --dry-run для заметок в каталоге проектов
- Добавь недостающие метаданные во все markdown-файлы базы знаний
Как установить metadata-agent
1Через claude-code-templates
npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agent2Вручную: положить файлы
.claude/agents/metadata-agent.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/metadata-agent.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/metadata-agent.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о metadata-agent
Как установить metadata-agent в Claude Code?
Выполните команду npx claude-code-templates@latest --agent obsidian-ops-team/metadata-agent. Шаблон субагента сохранится в файл .claude/agents/metadata-agent.md.
Что делает metadata-agent?
Он проверяет markdown-файлы в хранилище Obsidian и проставляет унифицированные метаданные frontmatter с тегами, типами заметок, статусом и датами.
Зачем нужен тестовый прогон с флагом --dry-run?
Команда python3 /Users/cam/VAULT01/System_Files/Scripts/metadata_adder.py --dry-run выводит список файлов, требующих обновления, позволяя проверить разметку перед фактической записью в документы.
