diagram-indexer

Index Mermaid and Obsidian Canvas diagrams with incremental file scanning.

4|1|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/rongarede/skill-snapshots --skill diagram-indexer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-indexer
Source: https://github.com/rongarede/skill-snapshots/tree/main/utilities/diagram-indexer
Command: npx skills add https://github.com/rongarede/skill-snapshots --skill diagram-indexer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of locating diagram elements across large documentation by incrementally indexing Mermaid and Obsidian Canvas diagrams.

Core Features & Use Cases

  • Incremental indexing: Only processes files that have changed, updating the index without scanning the entire repository.
  • Node-level mapping: Builds a direct file-to-node ID mapping to quickly locate where a node appears.
  • Use Case: Imagine a large spec document set; you want to know which file defines a given diagram node, or track changes across updates.

Quick Start

Use bun to run the indexer on a target directory, for example: bun scripts/index.ts docs/CALL_FLOW After indexing, you can query for a node with a helper like findNodeLocation(index, "User").

Frequently Asked Questions about diagram-indexer

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

FAQPage Schema
How do I find which file contains a specific node in Mermaid diagrams?

To find which file contains a specific node in Mermaid diagrams, you can incrementally index your documentation to build a direct file-to-node mapping. This allows you to quickly query and locate the exact file where a given diagram node appears.

Can I index Obsidian Canvas files without installing extra parsing libraries?

Yes, you can index Obsidian Canvas files without extra parsing libraries by using a zero-dependency parsing approach. The indexer processes Canvas files natively, while Mermaid blocks are extracted via simple parsing without requiring additional software packages.

How do I incrementally index diagram changes without scanning the entire repository?

You incrementally index diagram changes by running the indexer on a target directory, which only processes files that have changed. This updates the existing index efficiently without scanning the entire repository, saving time on large documentation sets.

What is the best way to locate diagram elements across large software engineering documentation?

The best way to locate diagram elements across large software engineering documentation is to use an incremental indexing tool that builds a node-level mapping. This targets extensive diagram workflows by tracking changes and enabling quick queries for specific elements.

Does this diagram indexing approach work with both Mermaid and Obsidian Canvas formats?

Yes, this diagram indexing approach works with both Mermaid and Obsidian Canvas formats. It extracts Mermaid blocks using simple parsing and processes Canvas files with zero dependencies, building a unified file-to-node mapping for both.

Why should I use incremental indexing for documentation diagrams instead of a full scan?

You should use incremental indexing instead of a full scan because it only processes changed files, updating the index efficiently. This avoids the overhead of scanning the entire repository every time a diagram is modified, which is critical for large spec document sets.