vault-stats

Analyze Obsidian vault health and usage metrics into Markdown reports.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/abhattacherjee/obsidian-brain --skill vault-stats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-stats
Source: https://github.com/abhattacherjee/obsidian-brain/tree/main/skills/vault-stats
Command: npx skills add https://github.com/abhattacherjee/obsidian-brain --skill vault-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vault health analytics helps you understand the overall health of your Obsidian vault, track usage, and save reports for trend analysis. It highlights signal coverage, access patterns, and notes importance distribution, enabling proactive vault maintenance. Use when: you want to monitor vault health, see how notes are accessed, or compare project activity over time.

Core Features & Use Cases

  • Vault-wide health metrics and current project usage analytics
  • Reports saved as vault notes for trend tracking
  • Signal coverage insights: activation, importance, and full access patterns
  • Top accessed notes and project-specific activity to guide focus
  • Optional snapshots and long-term trend visibility

Quick Start

Run /vault-stats to generate a vault health report and save it to your vault for trend tracking.

Frequently Asked Questions about vault-stats

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

FAQPage Schema
How do I generate vault health and usage analytics for my Obsidian notes?

To generate vault health analytics, run the vault-stats command to read your vault configuration and compute metrics like total notes, database size, and access log entries, producing a formatted Markdown report.

What metrics are included in a vault health report for tracking note usage?

A vault health report includes metrics such as total notes, database size, access log entries, oldest access date, note activation, importance distribution, and top accessed notes to help you track usage trends over time.

Can I save vault usage reports as notes for long-term trend analysis?

Yes, vault usage reports are saved directly as Markdown notes to your configured vault path, allowing you to retain snapshots of signal coverage and access patterns for long-term trend visibility and proactive maintenance.

Does vault analytics work for tracking project-specific activity and access patterns?

Yes, vault analytics tracks project-specific activity and full access patterns, revealing note activation, importance distribution, and top accessed notes to help you monitor ongoing project activity and guide your focus.

When should I use vault health dashboards for my notes database?

You should use vault health dashboards when you have vaults with ongoing activity and need to monitor vault health, compare project activity over time, or understand how notes are accessed to enable proactive vault maintenance.