paper-lint

Audit Obsidian wikis for structural issues and apply safe repairs.

10|1|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/zzzlxhhh/obsidian-paper-curator --skill paper-lint
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paper-lint
Source: https://github.com/zzzlxhhh/obsidian-paper-curator/tree/main/.agents/skills/paper-lint
Command: npx skills add https://github.com/zzzlxhhh/obsidian-paper-curator --skill paper-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Health-check and auto-repair the Obsidian wiki. Trigger when the user asks to lint, audit, health-check, or scan the wiki for quality issues. Fixes structural issues: orphan pages with no inbound links, broken wikilinks, missing concept pages for frequently-linked terms, and missing cross-references. Automatically fixes repairable issues and writes a detailed report with diffs to the LintLog/ directory.

Core Features & Use Cases

  • Structural health checks that identify and repair orphaned pages, broken links, missing concepts, and cross-reference gaps.
  • Automatic generation of a detailed LintLog report with before/after diffs to guide review.
  • Safe, idempotent fixes that augment navigation without duplicating concepts or links.

Quick Start

Run paper-lint to scan the wiki, fix safe issues, and generate a LintLog report.

Frequently Asked Questions about paper-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find and fix orphan pages in my Obsidian wiki?▼

To fix broken wikilinks in Obsidian, run a vault audit that detects unresolved links and applies idempotent repairs. The process updates cross-references without duplicating content and outputs a diff report to the LintLog directory.

What is the best way to audit Obsidian vault structure for missing concept pages?▼

Auditing Obsidian vault structure for missing concept pages involves scanning for frequently-linked terms that lack corresponding notes. The scan applies safe repairs to augment navigation and writes a detailed LintLog report with before and after diffs.

How do I generate a health-check report for my Obsidian wiki?▼

Generate an Obsidian wiki health-check report by running a vault scan that identifies structural issues like orphan pages and broken links. The scan outputs a detailed LintLog report containing before and after diffs to guide review.

When should I scan my Obsidian wiki for cross-reference gaps?▼

Scan your Obsidian wiki for cross-reference gaps when you suspect missing connections between related notes. The audit identifies these gaps, applies safe repairs to augment navigation, and logs the changes in a detailed LintLog report.