Skip to content
Back to skills

Lint

ASecurity

Vault health check for a learning vault - orphans, duplicates, broken links, theorems without proofs, frontmatter drift, primer problems and review backlog. Report only, no fixes.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgo

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add jlu1023/learning-stack --skill lint --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Lint?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Lint
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/jlu1023-lint/badge)](https://www.skillsdirectory.com/skills/jlu1023-lint)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: lint
description: Vault health check for a learning vault - orphans, duplicates, broken links, theorems without proofs, frontmatter drift, primer problems and review backlog. Report only, no fixes.
---

Walk the vault and produce a structured report. Change nothing.

1. **Orphans:** notes with no inbound and no outbound links.
2. **Duplicates:** near-duplicate note titles (case-insensitive, plurals, common variants).
3. **Broken links:** a wikilink `[[X]]` or a relative Markdown link `[x](X.md)` whose target does not exist.
4. **Contradictions:** notes that make contradictory claims about the same concept. Quote the excerpts.
5. **Theorems without proofs:** `type: theorem` notes with no linked `type: proof` note (unless `proof_pending: true` explains why).
6. **Proofs without theorems:** `type: proof` notes whose theorem link is broken.
7. **Definitions never used:** `type: definition` notes with no inbound `depends_on` or link.
8. **Stale content:** notes with `updated:` more than 180 days ago and `status: seedling` or the `#stub` tag.
9. **Stale MOCs:** MOCs where at least 30% of linked notes no longer exist.
10. **Topic tags:** any hashtag in use that is not in the tag registry in `CLAUDE.md`.
11. **Frontmatter drift:** notes missing the required fields for their type (see `CLAUDE.md`), for example a theorem with no `depends_on`.
12. **Primers:** run `VL check-primer all` (`VL` is the engine command in the `method` skill) and list every failing primer and every unit without one.
13. **Review backlog:** from `VL due mixed`, the number of overdue notes and due redos; from `VL proofs mixed`, the number of proofs due.

Output, severity-ordered:

```
# Lint Report - <day month year>

## Severe (breaks navigation or correctness)
- Broken links: ...
- Contradictions: ...

## Important
- Theorems without proofs: ...
- Failing primers: ...
- Tags not in the registry: ...

## Cleanup
- Orphans: ...
- Stale stubs: ...
```

Name notes in plain text, not links. End by asking whether to stub the missing notes or fix any items now.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.