Unobsidian
Parse an Obsidian vault and explore its knowledge graph. Use when you need to query note connections, traverse neighbors of a node, search by tag, or resolve file paths within a vault.From its SKILL.md
npx -y skills add agent-hanju/unobsidian --skill unobsidianAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.2 KB, 516 tokens by cl100k_base, as published. Nobody here has run it
Unobsidian
A skill for parsing Obsidian-style markdown files and exploring the knowledge graph. Works without Obsidian installed or running.
Prerequisites
pip install obsidian-parse
Commands
All commands take --vault as the path to the vault directory.
Output is always JSON.
Full graph
python ${CLAUDE_SKILL_DIR}/scripts/get_graph.py --vault /path/to/vault [--format adjacency|d3]
Parses all markdown files and builds a knowledge graph.
Default output is compressed adjacency format (one node per line, #prefix for tags, quoted if name contains spaces). Use --format d3 for D3.js compatible JSON.
Neighbor traversal
python ${CLAUDE_SKILL_DIR}/scripts/get_neighbors.py --vault /path/to/vault --node MyNote --depth 2 [--format adjacency|d3]
--node: Node ID (filename without.md, or#tagnamefor tags)--depth: BFS depth (default: 1, max: 3)--format: Output format (default: adjacency — compressed text, d3 also supported)
Tag search
python ${CLAUDE_SKILL_DIR}/scripts/search_by_tag.py --vault /path/to/vault --tag project
Supports nested tags. Searching #project also matches #project/frontend.
Resolve file path
python ${CLAUDE_SKILL_DIR}/scripts/resolve_filepath.py --vault /path/to/vault --file-id ProjectA
Visualize graph
python ${CLAUDE_SKILL_DIR}/scripts/visualize_graph.py --vault /path/to/vault [--output graph.html] [--no-open]
Renders the full vault graph as an interactive D3.js force-directed HTML file and opens it in a browser.
--output sets the output path (default: <vault>/graph.html), --no-open disables auto-open.
Key notes
- Output is always JSON
- Node types:
file(markdown file),tag - Link types:
wikilink,embed,tag - Node ID is the filename without
.md— must be unique within the vault - Backlinks (notes pointing to a given note): use get_neighbors — it traverses bidirectionally
What ships with it: 5 files
15.1 KB alongside SKILL.md, 5 of them executable
scripts/
- get_graph.pyruns1.8 KB
- get_neighbors.pyruns3.9 KB
- resolve_filepath.pyruns1.1 KB
- search_by_tag.pyruns1.3 KB
- visualize_graph.pyruns7.0 KB