Skip to content
self.md

■ SKILLS // SKILL SPECS

obsidian-vault-manager

Manage Obsidian knowledge base with smart capture, AI-powered tagging, and publishing workflows

Author Zorro Cheng Published Updated Read 3 min
■ [!] ON THIS PAGE ▼
■ INSTALL // npx @self.md/cli install obsidian-vault-manager
AuthorZorro Cheng
Namespace@ZorroCheng-MC/obsidian-vault-manager
Category#general
Version1.0.0
Stars★ 0
Downloads↓ 7
Verification[ ✓ ] self.md verified
View Source ↗

Manage Obsidian knowledge base with smart capture, AI-powered tagging, and publishing workflows

Installation

npx claude-plugins install @ZorroCheng-MC/obsidian-vault-manager/obsidian-vault-manager

Contents

Folders: scripts, templates

Files: README.md, SKILL.md

Documentation

Manage an AI-powered Obsidian knowledge base with automatic organization and GitHub Pages publishing.

Features

  • YouTube Video Capture: Fetch transcripts and create comprehensive notes (/youtube-note)
  • Smart AI Tagging: Automatic tagging based on content analysis (/capture, /idea)
  • Bundled Scripts: Executable scripts for transcript fetching and publishing
  • Template System: Consistent note structure across all content types
  • GitHub Pages Publishing: Publish notes to your public sharehub (/publish)
  • URL-Based Sharing: Share notes via URL with no server storage (/share) - Plannotator-compatible

Installation

  1. Add the plugin marketplace:
/plugin marketplace add ZorroCheng-MC/obsidian-vault-manager-plugin
  1. Install the plugin:
# Option A: Browse available plugins
/plugin

# Option B: Install directly
/plugin install obsidian-vault-manager@ZorroCheng-MC/obsidian-vault-manager-plugin
  1. Verify installation:
/plugin list
# Should show: obsidian-vault-manager

Manual Installation (Legacy)

For development or when marketplace is unavailable:

# Clone to Claude plugins directory
mkdir -p ~/.claude/plugins
cd ~/.claude/plugins
git clone https://github.com/ZorroCheng-MC/obsidian-vault-manager-plugin.git obsidian-vault-manager

# Make scripts executable
chmod +x ~/.claude/plugins/obsidian-vault-manager/scripts/core/*.sh

Bundled Resources

Scripts

Core Scripts (scripts/core/):

  • fetch-youtube-transcript.sh - Fetches YouTube transcripts using youtube_transcript_api

Validation Scripts (scripts/validation/):

  • validate-frontmatter.py - Validates note frontmatter structure

Templates

templates/youtube-note-template.md - Structured template for YouTube video notes with:

  • Comprehensive frontmatter
  • Learning objectives
  • Curriculum structure
  • Key takeaways sections
  • Rating and tags analysis

Usage

In Claude Code CLI

# Capture YouTube video
/youtube-note https://youtu.be/VIDEO_ID

# Capture quick idea
/idea My brilliant idea about AI agents

# Publish to GitHub Pages
/publish my-note.md

# Share via URL (no server storage)
/share my-note.md

Share Command Details

The /share command creates a shareable URL with the note content encoded directly in the URL (Plannotator-style):

https://zorrocheng-mc.github.io/sharehub/share.html#<compressed-base64>

Features:

  • No server storage - content lives in the URL
  • Recipients can add comments/annotations
  • Comments generate new URLs for sharing back
  • Compatible with Plannotator format

Limitations:

  • Large notes (>10KB) create very long URLs
  • For large content, use /publish instead

In Claude Desktop

Simply provide a YouTube URL:

Create a note from this video: https://youtu.be/VIDEO_ID

Optional: Automatic Validation Hooks

For advanced users who want automatic frontmatter validation before note creation, you can configure hooks in your Claude Code settings.

Hook Setup

Add the following to your ~/.claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "description": "Validate frontmatter before creating Obsidian notes",
        "matcher": "mcp__obsidian-mcp-tools__create_vault_file",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/skills/obsidian-vault-manager/scripts/validation/validate-frontmatter.py"
          }
        ]
      }
    ]
  }
}

What Hooks Do

When configured, the validation hook will:

  • ✅ Run automatically before every note creation
  • ✅ Check for required frontmatter fields (title, tags, date, type)
  • ✅ Validate tag structure (must be a list)
  • ✅ Verify content type tag is present (video, article, idea, etc.)
  • ✅ Warn if ‘inbox’ tag is missing
  • ❌ Block creation if validation fails

Hook Behavior

Exit Codes:

  • 0 - Validation passed, allow creation
  • 1 - Warning only, allow creation with message
  • 2 - Validation failed, block creation

Without Hooks: Claude runs validation script as part of SKILL.md workflow (default behavior)

With Hooks: Automatic enforcement before any Obsidian note creation (opt-in)

Testing Scripts

Test Transcript Fetching

# Test with a video ID
~/.claude/skills/obsidian-vault-manager/scripts/core/fetch-youtube-transcript.sh jI2LC3WTryw

Test Validation

# Create a test file
cat > test-note.md << 'EOF'
---
title: "Test Video"
tags: [video, AI, inbox]
date: 2025-10-28
type: video
---
# Test
EOF

# Validate it
python3 ~/.claude/skills/obsidian-vault-manager/scripts/validation/validate-frontmatter.py test-note.md

Tag Taxonomy

Content Type Tags (choose 1)

  • idea, video, article, study-guide, repository, reference, project

Topic Tags (choose 2-4)

  • AI, productivity, knowledge-management, development, learning,

Source

View on GitHub

[!] SKILL TAGS //
#general