mcpField
O
obsidian-dashboard

obsidian-dashboard

github.com/oldwinterProductivity1050 installsUpdated 1w ago
Repository

About obsidian-dashboard

obsidian-dashboard analyzes Obsidian vaults for people who want an overview of their notes and structure. It produces an interactive HTML dashboard, JSON statistics, and a Markdown report.

Key features

  1. 01File and type statistics
  2. 02Folder structure visualization
  3. 03Tag usage analysis
  4. 04Link and orphan detection
  5. 05Recent activity tracking
  6. 06Attachment usage statistics

Use cases

  1. 01Find broken links and orphaned files
  2. 02Review tag patterns and note organization
  3. 03Inspect folder and file-type distribution
  4. 04Track recent vault changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oldwinter/skills --skill obsidian-dashboard

After installing, type/obsidian-dashboardin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.DS_Store
references/
usage_examples.md
scripts/
analyze_vault.py

Details

From the project README

Obsidian Vault Dashboard Generator

This skill generates comprehensive statistics and visual overview of Obsidian note vaults. It analyzes files, tags, links, folder structure, and creates an interactive HTML dashboard.

Purpose

To provide detailed insights into Obsidian vault structure and content through automated analysis and visualization.

When to Use

  • When users want to understand their vault structure
  • To identify orphaned files, unused attachments, or broken links
  • To analyze tag usage patterns and note organization
  • To get file statistics and folder distribution
  • To visualize vault growth and organization

How to Use

  1. Run the Analysis Script

    # From this skill directory:
    python3 scripts/analyze_vault.py <vault_path>
    
  2. The script will generate:

    • vault_stats.json - Raw statistics data
    • dashboard.html - Interactive HTML dashboard
    • vault_report.md - Markdown summary report
  3. Dashboard Features:

    • File count and type distribution
    • Folder structure visualization
    • Tag usage analysis
    • Link analysis (internal/external/broken)
    • Recent activity tracking
    • Orphaned files detection
    • Attachment usage statistics

Key Metrics Tracked

  • File Statistics: Total files, notes, attachments, size distribution
  • Type Analysis: .md, .pdf, .png, .jpg, .gif, .svg, .mp4, .webm, .mp3, .wav, .m4a
  • Tag Analysis: Unique tags, tag frequency, nested tag structure
  • Link Analysis: Internal links, external links, broken links, orphaned files
  • Folder Structure: Depth, distribution, empty folders
  • Content Analysis: Empty files, large files, old files
  • Activity Tracking: Recently modified, created dates

Output Files

  • dashboard.html: Interactive dashboard with charts and tables
  • vault_stats.json: Raw data for further processing
  • vault_report.md: Markdown summary for vault documentation

Comments

Markdown supported