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
- 01File and type statistics
- 02Folder structure visualization
- 03Tag usage analysis
- 04Link and orphan detection
- 05Recent activity tracking
- 06Attachment usage statistics
Use cases
- 01Find broken links and orphaned files
- 02Review tag patterns and note organization
- 03Inspect folder and file-type distribution
- 04Track recent vault changes
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ oldwinter/ skills --skill obsidian-dashboardAfter installing, type/obsidian-dashboardin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.DS_Storereferences/usage_examples.mdscripts/analyze_vault.pyDetails
From the project READMEObsidian 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
-
Run the Analysis Script
# From this skill directory: python3 scripts/analyze_vault.py <vault_path> -
The script will generate:
vault_stats.json- Raw statistics datadashboard.html- Interactive HTML dashboardvault_report.md- Markdown summary report
-
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 tablesvault_stats.json: Raw data for further processingvault_report.md: Markdown summary for vault documentation
Comments
Markdown supported