| name | lint |
| description | Use when user says "lint", "health check", "audit". Checks vault for missing frontmatter, broken wikilinks, orphans, stub notes, inconsistent tags, TODO markers, stale content; saves report to `_outputs/reports/`. |
LINT
When to use
Trigger phrases: "lint", "health check", "audit". The user wants a health report for the vault.
Workflow
Check the vault for the following classes of issues:
- Missing or incomplete frontmatter (no
title, date, tags, or type).
- Broken wikilinks (cross-reference
content/_indexes/graph.md against actual files).
- Orphan notes (no incoming wikilinks).
- Stub notes (very short body, mostly empty sections).
- Inconsistent tags (typos, near-duplicates like
book vs books).
- Outstanding TODO markers (
#todo, #todo/replace, #todo/complete).
- Missing
summary: field in frontmatter.
- Notes that should logically link to one another but do not (semantic neighbors absent from
graph.md).
- Stale content (notes with
date: older than 1 year and no agent-reviewed: within the last year).
- Template compliance — every note's
type: matches one of the allowed values from CLAUDE.md.
Save the report to content/_outputs/reports/YYYY-MM-DD_health-report.md. Print summary counts to the user (issues per class).
Scripts
Run the two canonical scanners from the vault root instead of ad-hoc greps (both emit JSON, UTF-8 safe):
python .claude/skills/lint/scripts/lint_scan.py — classes 1, 4, 6, 9, 10 (frontmatter, stub, TODO, stale, type/schema) + title_filename_mismatch.python .claude/skills/lint/scripts/lint_links.py — classes 2, 3 (broken wikilinks + orphans). Resolves aliases ([[Note|alias]], table-escaped [[Note\|alias]]), anchors (#…), path links, templates/, and asset embeds (png/pdf/jpg/webm/gif/svg/webp/ATTACHMENTS).
Feed their JSON into the report. Classes 5 (tag near-dupes) and 8 (missing semantic links) still need human judgment. Note: lint_links.py reports raw broken links — triage into asset-embeds / prose examples / skill-refs / genuinely-missing before quoting a headline number.
See also
CLAUDE.md "Navigation Protocol" — read on every operation before this workflow.
