vault-review

Builds a scored review queue of Obsidian notes and walks users through an interactive review session.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-review-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-review
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-knowledge/skills/vault-review
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-review-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Notes in a personal knowledge vault go stale, stay orphaned, or never get revisited. This Skill ranks notes by review urgency and guides a structured daily, weekly, or monthly review ritual so important ideas resurface instead of being forgotten. ## Core Features & Use Cases - Composite scoring queue: Ranks notes by days since last review, orphan status (zero outlinks), and maturity stage (seedling to ancient-tree), then surfaces the top 5-15 notes per session. - Interactive review session: Presents each note with actions to mark done, skip, edit, promote maturity, or archive, updating the last_reviewed frontmatter only after user confirmation. - MOC gap detection: Dispatches a gap-detector agent in parallel to surface topic clusters lacking Maps of Content alongside the review queue. - Use Case: Run a weekly review of your Obsidian vault to resurface 10 neglected seedling notes, promote two that have matured, and archive three that are no longer relevant. ## Quick Start Start a weekly review of my Obsidian vault and show me the ranked queue of notes that need attention.

Frequently Asked Questions about vault-review

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

FAQPage Schema
How do I review notes in my Obsidian vault systematically?

Run a vault review session that scores notes by days since last review, orphan status, and maturity stage, then presents a ranked queue. You confirm each note as done, skipped, promoted, or archived, and the skill updates the last_reviewed frontmatter automatically.

How are notes ranked for review in an Obsidian vault?

Notes receive a composite score: days since last review divided by 30, plus a penalty of 10 for zero outlinks, plus a maturity weight (seedling 3, sapling 2, tree 1, ancient-tree 0). Scores cap at 20 and the top notes fill the queue.

What frontmatter fields does the review workflow use?

It reads last_reviewed (ISO date), maturity (seedling, sapling, tree, or ancient-tree), and created as a fallback age signal. It writes last_reviewed after confirmed reviews and updates maturity when you promote a note.

Can I review notes without the queue system?

Yes, for a quick single-note review you can read and edit the note directly. The queue system is designed for structured daily, weekly, or monthly rituals where ranking prevents interest-driven selection bias.

What happens if my vault has no permanent notes folder?

The skill falls back to globbing the whole vault while excluding daily, templates, attachments, .obsidian, and archive folders. If zero notes are found, it asks you to confirm the correct folder path rather than guessing.