vault-lint
Use to lint a vault, run a health check, or find orphans and broken wikilinks. Report-only, any Obsidian vault.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 15
- Forks
- 2
01 前言 Front Matter
- name
- vault-lint
- description
- Use to lint a vault, run a health check, or find orphans and broken wikilinks. Report-only, any Obsidian vault.
02 资源文件 4
- 脚本check-vendor-drift.sh3.4 KB
- 参考文档default-profile.json484 B
- 参考文档UPSTREAM.json427 B
- 脚本vault_lint.py8.6 KB
03 SKILL.md 正文
Run the vault-lint engine against a vault root. Deterministic, report-only, filesystem-only.
-
Resolve the vault root. Use the explicit
$ARGUMENTSpath if provided, elsecwd. Abort if the path does not exist or has no*.mdfiles. -
Run the engine as a single literal command, absolute path, no
cd. The cadence that runs this skill unattended fires withcwdset to the vault, not a himmel checkout — a repo-relative path forces acd <repo> && python …paraphrase, which is a compound shape the cadence's engine-allow hook never grants. Resolve the himmel repo root from the$HIMMEL_REPOenvironment variable (auto-set on every adopted machine) and substitute its literal value into the command text — do not write$HIMMEL_REPOor${CLAUDE_PLUGIN_ROOT}in the actual invocation: a$token in the engine path is refused outright, andCLAUDE_PLUGIN_ROOTresolves to the plugin's installed cache copy, not this repo, which the hook does not trust either. If$HIMMEL_REPOis unset, ask the operator for the himmel repo path (interactive) or abort the run (unattended) rather than guessing:python "<himmel-repo-root>/marketplace/plugins/obsidian-triage/skills/vault-lint/vault_lint.py" "<vault>"e.g.
python "C:/Users/op/himmel/marketplace/plugins/obsidian-triage/skills/vault-lint/vault_lint.py" "<vault>". The engine loads<vault>/.vault-lint.jsonif present, otherwise uses its shipped defaults. It writes the report to the configuredreport_path(default<vault>/_lint-report-{date}.md, date-substituted) and prints a JSON summary to stdout. -
Read the printed JSON summary. Surface to the operator:
N real findings → <report_path>Do NOT re-walk the vault from Claude — the engine is the single deterministic pass. Repeating the crawl in Claude produces non-deterministic, over-reported results (the over-report collapse — hundreds of raw issues down to a handful of real ones — is baked into the engine's resolver and by-design exemptions; re-crawling from scratch loses it).
-
Filesystem-only: never call WebFetch, WebSearch, or any MCP tool. In an
egress_lockedvault these are blocked by a hook anyway — rely solely on the engine output. -
Report-only: never auto-fix findings in v1. Findings are informational; the operator decides what to act on.
Flags: --json prints full per-finding detail (useful for piping); --config PATH overrides
the profile location; --no-report suppresses the written report (stdout-only run).
Vendor-drift guard: marketplace/plugins/obsidian-triage/skills/vault-lint/check-vendor-drift.sh
(lean-invoke — run manually or via /himmel-update; not a pre-commit hook) flags when the upstream
claude-obsidian:wiki-lint this skill generalizes has changed, so capability gaps surface for review.
04 同仓库更多 Skills
medic
Use inside a Salus medical vault to FILE a medical item into its structured place (skin photo → photo archive + capture note; lesion/symptom note; lab/PDF → 00-Sources) and auto-commit, OR to QUERY the vault for a health follow-up (grounded answer + flagged, non-diagnostic morphology read). Triggers on "file this photo / note / lab", "log this into the medical vault", "ask the medic", or any health follow-up while cwd = the medical vault. Organize & surface only — never diagnose (posture-A).
stuck-playbook
fixture skill, invoked in the basic transcript fixture
never-used-skill
fixture skill, never invoked in any fixture transcript
used-skill
fixture skill invoked via a Skill tool_use in the fixture transcript
dead-skill
fixture skill never invoked and never referenced
jira-transition
Move/transition a Jira issue status ("move PROJ-46 to In Progress"). Needs key + target status. Not PR status changes.