К основному содержанию
скилл CX Codex

vault-lint — скилл для Claude Code и Gemini CLI: аудит Obsidian

Скилл vault-lint проверяет хранилище Obsidian по пяти направлениям: фронтматтер, происхождение заметок, устаревшие источники, покрытие MOC и сироты.

ISC ★ 102 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add thoreinstein/gemini-obsidian --skill vault-lint -a claude-code
Открыть на GitHub

Что делает vault-lint

Скилл проходит по заметкам в Engineering/ и сверяет фронтматтер с конвенциями хранилища: type должен быть pattern, trap, decision или concept, плюс на месте project, status, tags и created. Проблемные заметки попадают в отчёт, а исправить их можно по одной через obsidian_update_frontmatter — с подтверждением.

Дальше смотрит на блок provenance: если inferred больше 0.5, заметка в основном синтезирована, если ambiguous больше 0.1 — остались нерешённые противоречия. Устаревшие источники ищутся через .manifest.json в корне хранилища: время файла на диске сравнивается с ingested_at, а обновить заметки можно командой /wiki-ingest --force <source>. Нет манифеста — этот шаг выпадает, остальные четыре раздела отчитываются как обычно.

Покрытие MOC считается по вики-ссылкам из заметок в MOCs/, у заметок моложе 24 часов есть фора, а obsidian_rag_query подсказывает, в какой MOC добавить пропущенную. Поиск сирот отдан скиллу /link-audit. Отчёт разбит на Critical, Warning, Info и Stats, а запуск можно сузить до папки (/vault-lint Engineering/Patterns/) или до одной проверки (/vault-lint --check frontmatter).

Какие задачи решает

  • найти заметки в Engineering/ без обязательных полей фронтматтера
  • отловить заметки с высокой долей inferred в provenance
  • обновить заметки, у которых исходник на диске новее ingested_at
  • проверить, что свежие заметки попали хотя бы в один MOC
  • получить отчёт о здоровье хранилища по приоритетам

Примеры запросов агенту

  • Прогони /vault-lint по хранилищу и начни с раздела Critical.
  • Проверь только фронтматтер: /vault-lint --check frontmatter.
  • Запусти /vault-lint Engineering/Patterns/, чтобы не ждать полный обход.

Как установить vault-lint

1Через Skills CLI (Vercel)

npx skills add thoreinstein/gemini-obsidian --skill vault-lint -a claude-code

2Вручную: положить файлы

~/.claude/skills/vault-lint/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/vault-lint/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о vault-lint

Как установить vault-lint в Claude Code?

Выполните npx skills add thoreinstein/gemini-obsidian --skill vault-lint -a claude-code. Файл скилла окажется по пути ~/.claude/skills/vault-lint/SKILL.md.

Что делает vault-lint?

Проверяет хранилище Obsidian по пяти пунктам: обязательные поля фронтматтера, дрейф provenance, устаревшие источники, покрытие MOC и сироты. Итог — отчёт с приоритетами и предложениями по исправлению.

Что нужно для проверки устаревших заметок?

Файл .manifest.json в корне хранилища: из него берётся ingested_at для каждого источника. Без манифеста шаг пропускается, остальные проверки идут своим ходом.

Исходный текст

SKILL.md · ISC
---
name: vault-lint
description: >-
  Use when the user wants a health audit of the vault — stale content,
  provenance drift, frontmatter compliance, or MOC coverage gaps. Triggers
  on "lint vault", "vault health", "check vault", "stale notes", "vault
  audit", "vault quality", or "check conventions".
---

# Vault Lint

Comprehensive vault health audit. Checks five dimensions and presents a prioritized report with fix options.

## Checks

### 1. Frontmatter Compliance

Scan `Engineering/` notes for missing required frontmatter fields per VAULT_CONVENTIONS:

1. Call `obsidian_list_notes` with `subfolder: "Engineering"`.
2. For each note, call `obsidian_read_note` and check frontmatter for:
   - `type:` — must be pattern, trap, decision, or concept
   - `project:` — must be present
   - `status:` — must be present
   - `tags:` — must be a list
   - `created:` — must be a date
3. Report notes with missing or malformed fields.
4. Offer to fix with `obsidian_update_frontmatter` (one at a time, user confirms).

### 2. Provenance Drift

Find Engineering/ notes where the `provenance:` block suggests high uncertainty:

1. From the notes already read in Check 1, filter those with `provenance:` frontmatter.
2. Flag notes where `inferred` > 0.5 — these are majority-synthesized and may need source verification.
3. Flag notes where `ambiguous` > 0.1 — these have unresolved contradictions.
4. Report flagged notes with their provenance fractions.

### 3. Stale Content

If `.manifest.json` exists at vault root:

1. Read it with the `Read` tool.
2. For each entry in `sources`, check if `pages_created` or `pages_updated` notes still exist using `obsidian_read_note`.
3. If a source file's modification time on disk is newer than `ingested_at`, the derived notes may be stale.
4. Report stale notes and suggest re-ingesting with `/wiki-ingest --force <source>`.

If no `.manifest.json` exists, skip this check and note that no ingest tracking is available.

### 4. MOC Coverage

Check whether recent Engineering/ notes appear in at least one thematic MOC:

1. Call `obsidian_list_notes` with `subfolder: "MOCs"`.
2. For each MOC, call `obsidian_read_note` and extract all `[[wikilinks]]`.
3. Build a set of all notes referenced by at least one MOC.
4. Compare against the Engineering/ note list — any note not in the MOC set is uncovered.
5. Exclude notes created in the last 24 hours (grace period).
6. Report uncovered notes and suggest which MOC(s) they belong in via `obsidian_rag_query` (query the note title against MOC titles).

### 5. Orphan Check

Defer to the existing `link-audit` skill (Phase 2). Mention this in the report:
> "For orphan detection, run `/link-audit`."

## Report Format

Present findings as a prioritized summary:

```
## Vault Health Report

### Critical (fix now)
- 3 Engineering/ notes missing `type:` frontmatter
- 1 note with ambiguous provenance > 0.1

### Warning (review soon)
- 5 notes with inferred provenance > 0.5
- 2 notes with stale source material

### Info
- 8 Engineering/ notes not in any MOC
- Run `/link-audit` for orphan detection

### Stats
- Total Engineering/ notes scanned: N
- Frontmatter compliant: N/N (X%)
- Provenance tracked: N/N (X%)
- MOC coverage: N/N (X%)
```

## Arguments

- Optional scope: `/vault-lint Engineering/Patterns/`
- Optional check: `/vault-lint --check frontmatter` (run only one check)

## Tips

- Run after a batch `/wiki-ingest` to catch compliance issues early
- High `inferred` fractions aren't inherently bad — they just need periodic human review
- For large vaults, scope to a subfolder first to keep the audit manageable
- Pair with `/cross-linker` after fixing MOC coverage gaps

© thoreinstein · ISC · thoreinstein/gemini-obsidian

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
vault-cleanup-auditor BrianRWagner Скилл vault-cleanup-auditor для Claude Code проверяет хранилище Obsidian на старые черновики, незаполненные файлы, одинаковые имена и пустые папки. По запросу он сохраняет отчёт с датой. CX Codex +1 ★ 461звёзд репо wiki-lint AgriciDaniel Скилл wiki-lint прогоняет детерминированную проверку Obsidian-вики: битые ссылки, страницы-сироты, пробелы во frontmatter. Ничего не правит — только показывает. CX Codex +1 508установок metadata-agent davila7 Субагент metadata-agent приводит к единому стандарту frontmatter в заметках Obsidian. Он находит файлы без метаданных, проставляет типы, теги и даты создания. CX Codex 868установок obsidian-vault-management julianobarbosa Скилл obsidian-vault-management для Claude Code управляет хранилищем Obsidian по структуре PARA, создаёт заметки, настраивает ежедневники и собирает запросы Dataview. Организует ведение базы знаний через терминал. CX Codex +1 315установок Markdown Vault MCP pvliesdonk MCP-сервер Markdown Vault MCP даёт агенту доступ к папке с Markdown-заметками: искать по ключевым словам и по смыслу, читать разделы, писать обратно. Хранилище Obsidian подходит как есть. CX Codex +1 ★ 41звёзд репо vault-pkm AdrianV101 Плагин vault-pkm подключает Claude Code к хранилищу Obsidian, сохраняя контекст между проектами через 20 MCP-инструментов, семантический поиск и граф связей. ★ 16звёзд репо

Из того же набора15

Весь набор →
research Скилл research для Claude Code и Gemini CLI ищет сведения по теме в Obsidian vault, читает заметки и проверяет связанные ссылки. Отвечает на вопросы по собственной базе знаний. CX Codex +1 ★ 102звёзд репо moc-update Скилл moc-update находит карты контента (MOC) в Obsidian-хранилище, куда стоит добавить ссылку на только что созданную заметку из Engineering/. Срабатывает на фразы «update MOC», «add to MOC», «which MOCs». CX Codex +1 ★ 102звёзд репо link-audit Скилл link-audit находит битые ссылки и изолированные заметки в базе Obsidian. Помогает исправить пути или связать страницы семантическим поиском. CX Codex +1 ★ 102звёзд репо knowledge Скилл knowledge для Claude Code ищет повторяющиеся знания в заметках разных проектов и предлагает оформить их общей заметкой в Engineering/. Собирает идеи для переноса между проектами. CX Codex +1 ★ 102звёзд репо journal Скилл journal для дневника Obsidian: показывает сегодняшнюю заметку, дописывает быстрые логи и собирает обзоры за неделю или за день работы в CLI. CX Codex +1 ★ 102звёзд репо obsidian-companion Скилл obsidian-companion подключает агент к хранилищу Obsidian: позволяет искать заметки, вести ежедневные записи и отвечать на вопросы по базе через локальный RAG. CX Codex +1 ★ 102звёзд репо cross-linker Скилл cross-linker находит упоминания понятий из Obsidian vault без wikilinks и помогает связать заметки. Удобен, когда нужно проставить ссылки в выбранной папке или во всём хранилище. CX Codex +1 ★ 102звёзд репо wiki-ingest Скилл wiki-ingest разбирает внешние документы, PDF и выгрузки Readwise на атомарные заметки базы Obsidian с проверкой дубликатов через RAG и учётом источников. CX Codex +1 ★ 102звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой