reviewing-notes

Audit markdown notes for broken wiki-links, missing summaries, tags, and orphans.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/alexanderop/vault-astro --skill reviewing-notes-alexanderop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-notes
Source: https://github.com/alexanderop/vault-astro/tree/main/.claude/skills/reviewing-notes
Command: npx skills add https://github.com/alexanderop/vault-astro --skill reviewing-notes-alexanderop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The vault's knowledge base can accumulate broken wiki-links, missing summaries, weak tagging, and orphaned or low‑content notes, making navigation, discovery, and maintenance difficult.

Core Features & Use Cases

  • Link Validation: Detects and reports missing or broken [[wiki-link]] targets.
  • Frontmatter & Summary Checks: Flags notes lacking required title, type, date fields or a concise summary.
  • Tag & Content Quality: Highlights notes with fewer than two tags or with body content under 100 words.
  • Orphan Detection: Identifies notes with no incoming or outgoing wiki-links.
  • Maintenance Debt Review: Surfaces repeated concepts without dedicated pages, stale synthesis pages, and contradictory information.

Quick Start

Ask the skill to audit all notes and produce a categorized quality report for the vault.

Frequently Asked Questions about reviewing-notes

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

FAQPage Schema
How do I find broken wiki-links in my markdown notes?

To find broken wiki-links in markdown notes, audit the vault to detect and report missing or broken [[wiki-link]] targets. This link validation identifies navigation gaps within your knowledge base.

What is the best way to identify orphan notes in a knowledge base?

The best way to identify orphan notes in a knowledge base is to run a vault audit detecting markdown notes with no incoming or outgoing wiki-links. This isolates disconnected content for review.

How do I check markdown frontmatter for missing summaries and tags?

You check markdown frontmatter for missing summaries and tags by auditing note metadata. This flags notes lacking required title, type, date fields, a concise summary, or fewer than two tags.

Can I audit content quality in a markdown vault without external tools?

Yes, you can audit content quality in a markdown vault without external tools. A categorized report surfaces critical, high, medium, and low priority findings like short content under 100 words natively.

How do I review maintenance debt and stale synthesis pages in a wiki?

To review maintenance debt and stale synthesis pages in a wiki, audit the vault to surface repeated concepts without dedicated pages, stale synthesis pages, and contradictory information for prioritized maintenance.

Does the vault audit generate a prioritized report for low content notes?

Yes, the vault audit generates a prioritized report for low content notes. It categorizes findings into critical, high, medium, and low priority, highlighting body content under 100 words for maintenance.