skills.rest
Cain-Ish
Cain-IshCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

lint

Detect broken wiki links, orphan pages, and invalid PROJECT.md cross-references.

Updated Apr 24, 2026
Search Tags:#markdown#wiki#link validation#cross-references#filesystem scan#reference cleanup
One-click install
npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill lint-cain-ish
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lint
Source: https://github.com/Cain-Ish/claude-code-plugin/tree/main/skills/lint
Command: npx skills add https://github.com/Cain-Ish/claude-code-plugin --skill lint-cain-ish

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It detects structural issues in your local Second Brain wiki and project cross-references so your Claude context stays consistent and retrievable.

Core Features & Use Cases

  • Orphan wiki pages: Finds wiki pages that no other wiki page or PROJECT.md links to, then suggests whether to delete them or add a missing [[slug]] reference.
  • Dead [[wiki-links]]: Identifies [[slug]] references that don’t resolve to any existing wiki page and shows where they appear.
  • Broken Cross-references: Validates the slugs listed under Cross-references in each projects/*/PROJECT.md against real wiki pages.

Quick Start

Ask Claude to run the lint skill to produce a health report of orphan pages, dead wiki links, and broken PROJECT.md cross-references.

Frequently Asked Questions about lint

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

FAQPage Schema
How do I find broken wiki links and orphan pages in my local markdown notes?▼

Broken cross-references occur when slugs listed under Cross-references in PROJECT.md files do not resolve to existing wiki/<category>/<slug>.md pages. You can validate these references by checking each slug against your wiki directory to ensure they point to real, navigable markdown files.

What is a wiki orphan page and how do I clean up unused markdown references?▼

You do not need external dependencies to detect dead wiki-links; the process works by performing a filesystem scan to validate [[slug]] usage against existing markdown pages. It checks your local Second Brain wiki structure directly without requiring additional packages or tools.

How do I validate PROJECT.md cross-references against my wiki directory structure?▼

Run a wiki health-check by scanning all wiki pages and PROJECT.md files for [[slug]] usage and validity. The resulting health report details orphan pages, dead wiki-links, and broken cross-references, helping you maintain a consistent and retrievable knowledge base.

Why does my markdown wiki link point to a page that does not exist?▼

Your markdown wiki link points to a non-existent page when the [[slug]] reference does not match any file in your wiki/<category>/<slug>.md directory structure. This dead link happens when pages are renamed, deleted, or when slugs are typed incorrectly during note creation.

Related Skills

Explore More Software Engineering Skills→
Cain-IshCain-Ish

setup

Scaffold Second Brain hot-tier files and register projects in a JSONL registry.

Community
Intermediate
zzzlxhhhzzzlxhhh
10

paper-lint

Audit Obsidian wikis for structural issues and apply safe repairs.

Community
Advanced
thisismynewfmail-uithisismynewfmail-ui

llm-wiki

Create and maintain interlinked markdown knowledge bases with frontmatter and link structures.

Community
Advanced
Cain-IshCain-Ish

status

Report second-brain hot-tier and wiki health via filesystem inspection.

Community
Intermediate