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.