wiki-lint

Run lint checks on Obsidian-like vaults and output a structured health report.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/HelloWorldSungin/ark-skills --skill wiki-lint-helloworldsungin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-lint
Source: https://github.com/HelloWorldSungin/ark-skills/tree/main/skills/wiki-lint
Command: npx skills add https://github.com/HelloWorldSungin/ark-skills --skill wiki-lint-helloworldsungin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Vaults often suffer from broken wikilinks, missing or inconsistent frontmatter, stale index pages, and tag violations, which hinder reliable knowledge retrieval and automation.

Core Features & Use Cases

  • Lint checks for broken wikilinks, orphans, missing frontmatter, missing summaries, and tag violations to surface structural issues.
  • Validate vault integrity against taxonomy definitions and project discovery files (CLAUDE.md, taxonomy.md) to keep the vault aligned with project standards.
  • Generate a structured health report that can be consumed by automation or human reviewers to guide remediation.

Quick Start

Run the wiki-lint tool against your Ark project vault to emit a health report.

Frequently Asked Questions about wiki-lint

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

FAQPage Schema
How do I check an Obsidian vault for broken wikilinks and missing frontmatter?

To check an Obsidian vault for broken wikilinks and missing frontmatter, run lint checks that scan for orphaned pages, tag violations, and stale index pages, generating a structured health report to guide your vault remediation.

What does a vault health report include when auditing markdown lint issues?

A vault health report from markdown lint checks includes identified broken wikilinks, orphaned pages, missing frontmatter, stale index pages, and tag conformance violations, providing a structured overview for automation or human review.

How do I validate Obsidian vault integrity against project taxonomy rules?

To validate Obsidian vault integrity against project taxonomy rules, the lint process reads discovery files like CLAUDE.md and taxonomy.md to ensure frontmatter presence, link integrity, and tag conformance align with defined project standards.

Can I use markdown lint checks on vaults without YAML frontmatter definitions?

Markdown lint checks can run on vaults without YAML frontmatter, but they will flag missing frontmatter as a vault health issue. The tool relies on pyyaml to parse existing frontmatter and validate it against your taxonomy rules.

What is the best way to automate Obsidian vault linting for broken links and orphans?

The best way to automate Obsidian vault linting for broken links and orphans is to run the lint tool against your Ark project vault paths, which emits a structured health report that downstream automation pipelines can consume directly.