richfrem/agent-plugins-skills / plugins/agent-memory/.apm/skills/managing-obsidian-vaults
managing-obsidian-vaults
VerifiedInteractive vault, wiki and Super-RAG setup in the main conversation. Use for "set up my wiki", "initialize the full knowledge stack" or combined RLM/vector/wiki setup. Manage Obsidian vaults and LLM wikis: initialize vaults, author Markdown and wikilinks, safely edit notes and Bases, create Canvas diagrams, traverse graphs, build concept wikis, distill summary/bullets/deep layers, query and lint knowledge.
references/obsidian-graph-traversal.md
View on GitHub# Obsidian Graph Traversal (obsidian-graph-traversal)
Constructs an in-memory graph index from vault wikilinks to query forward links, backlinks, and multi-degree connection paths.
## Contents
- [Critical Constraints](#critical-constraints)
- [Dependencies](#dependencies)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
- [References](#references)
## Critical Constraints
- **Read-Only Traversal**: Graph query and index construction operations must never modify vault note files.
- **Timestamp Cache Invalidation**: The `.graph-index.json` cache must automatically invalidate and re-index notes whose `mtime` has changed.
- **Embed Distinction**: Disambiguate semantic links (`[[Note]]`) from embed transclusions (`![[Note]]`) to prevent false graph edges.
- **Query Performance**: Traversal operations must return within a sub-2-second budget across vaults with 1,000+ notes.
## Dependencies
Requires `obsidian-parser` and Python 3.8+ (standard library only for traversal operations).
## Quick start
```bash
# Build the graph index for a vault
python3 scripts/graph_ops.py build --vault-root <vault-path>
# Query backlinks for a specific note
python3 scripts/graph_ops.py backlinks --note "Note Name"
# Find orphaned notes without incoming or outgoing links
python3 scripts/graph_ops.py orphans --vault-root <vault-path>
```
## Workflow
1. **Phase 1: Index Building**: Parse vault notes via `obsidian-parser`, extract wikilinks, and cache adjacency lists in `.graph-index.json`.
2. **Phase 2: Topology Querying**: Execute forward-link, backlink, or multi-degree connection traversals from the in-memory graph.
3. **Phase 3: Orphan & Cluster Detection**: Identify isolated notes lacking connections or discover tightly coupled concept clusters.
4. **Phase 4: Impact Evaluation**: Assess upstream and downstream dependencies before executing multi-file refactoring operations.
## Verification
```bash
# Verify graph CLI commands
python3 scripts/graph_ops.py build --help
```
## References
- [acceptance-criteria.md](obsidian-graph-traversal-acceptance-criteria.md) - Graph traversal invariants and performance targets.
- [fallback-tree.md](obsidian-graph-traversal-fallback-tree.md) - Recovery procedures for missing indices or cyclic link paths.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |