lint

Detect structural and metadata issues in LLM Wiki vaults.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RonanCodes/llm-wiki --skill lint-ronancodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/RonanCodes/llm-wiki/tree/main/.claude/skills/lint
Command: npx skills add https://github.com/RonanCodes/llm-wiki --skill lint-ronancodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects structural, metadata, and linkage issues in an LLM Wiki vault so knowledge remains connected, sourced, and maintainable.

Core Features & Use Cases

  • Frontmatter validation: checks for missing or malformed YAML fields like title, date-created, page-type, domain, and sources and can auto-fill defaults.
  • Link and index integrity: finds broken wikilinks, orphan pages, and index mismatches and can create stubs for missing targets.
  • Content hygiene: surfaces stale content, concept gaps, and missing source sections, and generates a grouped Markdown report with suggested next actions and optional auto-commits.
  • Use Case: Run when preparing a vault for sharing or research to ensure pages are properly attributed, linked, and discoverable.

Quick Start

Use the lint skill to audit the vault named my-research and generate a Markdown report with suggested autofixes.

Frequently Asked Questions about lint

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

FAQPage Schema
How do I find broken wikilinks and orphan pages in an Obsidian vault?

To find broken wikilinks and orphan pages in an Obsidian vault, audit the directory structure to detect linkage issues and report mismatches. The lint skill scans your vault to ensure pages remain connected and generates a grouped Markdown report of any broken targets.

How do I validate YAML frontmatter in markdown files?

Validate YAML frontmatter in markdown files by checking for missing or malformed fields like title, date-created, page-type, domain, and sources. The lint skill performs this frontmatter validation and can optionally auto-fill missing defaults to maintain metadata consistency.

Can I automatically fix missing sources and frontmatter defaults in a wiki?

Yes, you can automatically fix missing sources and frontmatter defaults in a wiki by running an audit with the auto-fix flag. The lint skill applies optional fixes like stub creation for missing targets and frontmatter defaults, then produces a report suitable for git commit.

What is the best way to check index consistency and stale content in a knowledge base?

Check index consistency and stale content in a knowledge base by scanning for index mismatches and surfacing outdated pages. The lint skill audits your vault to detect these structural issues, ensuring your knowledge remains sourced, connected, and maintainable.

Does the wiki lint audit work with vaults stored under a specific directory?

The wiki lint audit works specifically with Obsidian-style vaults stored under the vaults/<name>/wiki directory path. It checks frontmatter validation, link resolution, and orphan detection for any vault matching this structural format.

Why does my wiki audit report show missing stubs for broken wikilinks?

Your wiki audit report shows missing stubs because broken wikilinks point to targets that do not exist in the vault. The lint skill detects these broken links during its audit and can optionally create stubs for the missing targets to restore index integrity.