skills.rest
philipyaz
philipyazCOMMUNITY
Explore all skills by this author →
GitHub

second-brain-lint

Check domain-split wikis for broken links, orphan pages, and structural issues.

4|1|Updated Jun 10, 2026
Search Tags:#linting#knowledge wiki#wiki integrity#broken link detection#orphan page identification
One-click install
npx skills add https://github.com/philipyaz/cos --skill second-brain-lint-philipyaz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: second-brain-lint
Source: https://github.com/philipyaz/cos/tree/main/vault/example-vault/.claude/skills/second-brain-lint
Command: npx skills add https://github.com/philipyaz/cos --skill second-brain-lint-philipyaz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures the structural integrity of your knowledge wiki by performing scheduled checks for filename consistency, broken links, orphan pages, and other issues that may compromise the knowledge base.

Core Features & Use Cases

  • Filename Consistency Check: Ensures that the filename matches the H1 title of each page.
  • Broken Link Detection: Checks for broken internal [[wikilinks]].
  • Orphan Page Identification: Flags pages without inbound links or index entries.
  • Strong Index Validation: Verifies that every page is under exactly one theme in the index.
  • Cross-Domain Leak Detection: Identifies leaks between work and life wikis.
  • Stray Task Check: Flags pages with task checkboxes, enforcing a knowledge-only policy.
  • Legacy File Removal: Checks for and flags deprecated files like priorities.md or reminders/.
  • Contradictions & Stale Claims: Flags conflicting information and outdated sources.

Quick Start

Run a lint check on your Second Brain's knowledge wiki by executing the 'second-brain-lint' command.

Frequently Asked Questions about second-brain-lint

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

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

You can detect broken internal wikilinks and identify orphan pages by running automated lint checks using grep and find commands on your markdown files. This process flags pages lacking inbound links or index entries.

What is the best way to enforce filename consistency and H1 title matching in a second brain?▼

Filename consistency is enforced by running a lint check that verifies each page's filename strictly matches its H1 title. This structural validation ensures your knowledge base remains organized and predictable.

How do I detect cross-domain leaks between separate work and life wikis?▼

Cross-domain leak detection identifies unauthorized content overlap between work, life, and shared wiki domains. The lint process operates independently on each domain to flag structural integrity issues.

Can I check for stray task checkboxes and legacy files in my markdown wiki?▼

Yes, wiki linting can flag pages containing task checkboxes to enforce a knowledge-only policy, while simultaneously checking for deprecated legacy files like priorities.md or reminders/.

Does the second-brain-lint script modify my wiki pages or require board access?▼

No, the lint script requires no board access and performs absolutely no page modification. It strictly operates in a read-only manner using grep and find commands to report knowledge integrity issues.

How do I validate strong index entries and single-theme assignments for wiki pages?▼

Strong index validation verifies that every page in your knowledge wiki is categorized under exactly one theme in the index. This lint check prevents duplicate or missing thematic assignments.

Related Skills

Explore More Product & Management Skills→
Everyone-Needs-A-CopilotEveryone-Needs-A-Copilot
13

link-validation

Validate Markdown links, anchors, and cross-references across repository files.

Official
Basic
ARCASSystemsARCASSystems
2

lint

Audit a wiki for broken links, orphan pages, and stale content.

Community
Advanced
DidierRLopesDidierRLopes
8

convert-beehiiv-newsletter

Convert Beehiiv newsletter posts into blog markdown files with front matter and images.

Community
Advanced
wahidyankfwahidyankf
3

docs-validating-links

Validate markdown links for internal paths, external URLs, and formatting compliance.

Community
Advanced