---

name: obsidian-batch description: "Batch processing for Obsidian vaults: bulk tag normalization, wikilink extraction/fixing, frontmatter edits, vault analysis, and migration workflows. Use when asked to analyze or modify many notes in an Obsidian vault at scale, or to script/automate vault-wide changes."

Obsidian Batch Processing Skill

Use this skill to perform repeatable, vault-wide operations on Obsidian markdown files. Keep this file lean and route to the correct reference or script instead of duplicating detail.

Routing Map (read only what you need)

• references/quickstart.md - Setup plus a 5-minute tutorial. Use for first run or quick orientation.
• references/cli-usage.md - Full CLI reference. Use for exact flags, subcommands, and examples.
• references/obsidian-syntax.md - Obsidian markdown syntax, regex patterns, and edge cases. Use when parsing or transforming content.
• references/processing-patterns.md - Advanced workflows, migrations, QA, rollback strategies. Use for multi-step or high-risk operations.
• examples/use-case-1-migrate-flat-to-hierarchical.md - Large-scale migration example.
• examples/use-case-2-fix-broken-links.md - Broken link repair example.
• examples/use-case-3-normalize-tags.md - Tag normalization example.
• examples/use-case-4-vault-statistics-report.md - Analytics/reporting example.

Script Index (entry points)

• scripts/batch_processor.py - Main CLI entry point and command routing.
• scripts/wikilink_extractor.py - Extract and analyze wikilinks.
• scripts/tag_normalizer.py - Normalize tags across a vault.
• scripts/frontmatter_processor.py - Bulk frontmatter operations.
• scripts/vault_analyzer.py - Vault statistics and health reports.

Standard Workflow

1. Back up the vault.
2. Run a dry run when available.
3. Execute the operation.
4. Verify results with a report or spot checks.

How to Use This Skill

• Pick the smallest reference file that answers the question.
• Summarize only what is needed, then point to the exact script or command.
• If the user asks for edits or new behavior, modify the relevant script and keep the CLI consistent with references/cli-usage.md.