Skip to content

richfrem/agent-plugins-skills / plugins/agent-memory/.apm/skills/managing-obsidian-vaults

managing-obsidian-vaults

Verified

Interactive 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.

FileKindSize
SKILL.mdskill md5.9 KB
assets/templates/config.yaml.templateother556 B
assets/templates/raw-sources.json.exampleother862 B
assets/templates/wiki-node.template.mdmarkdown410 B
evals/README.mdmarkdown569 B
evals/evals.jsonconfig23.4 KB
evals/legacy/obsidian-bases-manager/evals.jsonconfig692 B
evals/legacy/obsidian-bases-manager/results.tsvother301 B
evals/legacy/obsidian-canvas-architect/evals.jsonconfig731 B
evals/legacy/obsidian-canvas-architect/results.tsvother301 B
evals/legacy/obsidian-graph-traversal/evals.jsonconfig706 B
evals/legacy/obsidian-graph-traversal/results.tsvother301 B
evals/legacy/obsidian-init/evals.jsonconfig667 B
evals/legacy/obsidian-init/results.tsvother301 B
evals/legacy/obsidian-markdown-mastery/evals.jsonconfig652 B
evals/legacy/obsidian-markdown-mastery/results.tsvother301 B
evals/legacy/obsidian-query-agent/evals.jsonconfig767 B
evals/legacy/obsidian-rlm-distiller/evals.jsonconfig685 B
evals/legacy/obsidian-vault-crud/evals.jsonconfig638 B
evals/legacy/obsidian-vault-crud/results.tsvother301 B
evals/legacy/obsidian-wiki-builder/evals.jsonconfig732 B
evals/legacy/obsidian-wiki-linter/evals.jsonconfig1.5 KB
evals/results.tsvother73 B
evals/task-success.jsonconfig3.5 KB
references/acceptance-criteria.mdmarkdown2.9 KB
references/architecture-background.mdmarkdown2.8 KB
references/dependencies.mdmarkdown1.7 KB
references/interactive-setup.mdmarkdown7.0 KB
references/interactive-stack-setup.mdmarkdown5.6 KB
references/kepano-analysis-summary.mdmarkdown1.7 KB
references/obsidian-bases-manager-acceptance-criteria.mdmarkdown628 B
references/obsidian-bases-manager-fallback-tree.mdmarkdown787 B
references/obsidian-bases-manager.mdmarkdown2.1 KB
references/obsidian-canvas-architect-acceptance-criteria.mdmarkdown645 B
references/obsidian-canvas-architect-fallback-tree.mdmarkdown836 B
references/obsidian-canvas-architect.mdmarkdown1.9 KB
references/obsidian-graph-traversal-acceptance-criteria.mdmarkdown690 B
references/obsidian-graph-traversal-fallback-tree.mdmarkdown877 B
references/obsidian-graph-traversal.mdmarkdown2.2 KB
references/obsidian-init-acceptance-criteria.mdmarkdown650 B
references/obsidian-init-fallback-tree.mdmarkdown1.1 KB
references/obsidian-init.mdmarkdown2.0 KB
references/obsidian-markdown-mastery-acceptance-criteria.mdmarkdown700 B
references/obsidian-markdown-mastery-fallback-tree.mdmarkdown889 B
references/obsidian-markdown-mastery.mdmarkdown2.2 KB
references/obsidian-query-agent.mdmarkdown1.8 KB
references/obsidian-rlm-distiller.mdmarkdown1.8 KB
references/obsidian-vault-crud-acceptance-criteria.mdmarkdown833 B
references/obsidian-vault-crud-fallback-tree.mdmarkdown1.1 KB
references/obsidian-vault-crud.mdmarkdown2.2 KB
references/obsidian-vault-onboarding-guide.mdmarkdown3.7 KB
references/obsidian-wiki-builder.mdmarkdown1.8 KB
references/obsidian-wiki-linter.mdmarkdown1.7 KB
references/resource-index.mdmarkdown4.3 KB
references/safety-learnings.mdmarkdown2.7 KB
references/wiki-builder-guide.mdmarkdown2.7 KB
references/wiki-distillation-guide.mdmarkdown1.7 KB
references/wiki-linting-guide.mdmarkdown2.1 KB
references/wiki-query-guide.mdmarkdown2.1 KB
requirements.inother32 B
requirements.txtmanifest463 B
scripts/audit.pyscript9.0 KB
scripts/bases_ops.pyscript7.8 KB
scripts/canvas_gen.pyscript7.9 KB
scripts/canvas_ops.pyscript11.5 KB
scripts/concept_extractor.pyscript10.2 KB
scripts/constants.pyscript908 B
scripts/distill_wiki.pyscript12.9 KB
scripts/graph_ops.pyscript11.7 KB
scripts/ingest.pyscript8.3 KB
scripts/init_vault.pyscript5.7 KB
scripts/lint_wiki.pyscript9.3 KB
scripts/obsidian-parser/parser.pyscript6.5 KB
scripts/obsidian-parser/tests/test_parser.pyscript4.1 KB
scripts/query_wiki.pyscript21.3 KB
scripts/raw_manifest.pyscript14.3 KB
scripts/vault_ops.pyscript13.4 KB
scripts/wiki_builder.pyscript14.3 KB

references/obsidian-vault-onboarding-guide.md

View on GitHub
# Obsidian Vault Onboarding & Initialization Guide

## Contents
- [Prerequisites Installation](#prerequisites-installation)
- [Vault Initialization](#vault-initialization)
- [Exclusion Configuration](#exclusion-configuration)
- [Post-Init Verification](#post-init-verification)
- [Wiki Engine Guided Discovery](#wiki-engine-guided-discovery)
- [Portability & Quick Reference](#portability--quick-reference)

---

## Prerequisites Installation

### 1. Obsidian Desktop Application (Required)
The Obsidian desktop app must be installed on the host machine as the visual interface for browsing, editing, and viewing the Graph and Canvas.

- **macOS (Homebrew):**
  ```bash
  brew install --cask obsidian
  ```
- **Manual Download:** https://obsidian.md/download
- **Verify:**
  ```bash
  ls /Applications/Obsidian.app
  ```

### 2. Obsidian CLI v1.12+ (Recommended)
Communicates with running Obsidian instance via IPC lock for programmatic vault operations.

- **npm (global install):**
  ```bash
  npm install -g obsidian-cli
  ```
- **Verify:**
  ```bash
  obsidian --version
  ```

### 3. ruamel.yaml
Required for lossless YAML frontmatter parsing and preservation:
```bash
pip install ruamel.yaml
```

### 4. Optional Community Plugins
- **Dataview:** Structured database-style queries over frontmatter metadata.
- **Canvas:** Built-in visual boards adhering to JSON Canvas Spec 1.0.
- **Bases:** Table, grid, and card views from YAML properties.

---

## Vault Initialization

### Command Execution
```bash
# Interactive initialization
python ./init_vault.py --vault-root <path>

# With custom exclusions
python ./init_vault.py --vault-root <path> --exclude "custom_dir/" "*.tmp"

# Dry run validation only
python ./init_vault.py --vault-root <path> --validate-only
```

### Initialization Actions
1. **Validates** directory exists and contains markdown files.
2. **Creates** `.obsidian/` configuration directory.
3. **Writes** `app.json` with sensible developer defaults.
4. **Updates** `.gitignore` to exclude `.obsidian/`.
5. **Reports** next steps for opening vault in Obsidian desktop.

---

## Exclusion Configuration

### Default Exclusions
| Pattern | Reason |
|:--------|:-------|
| `node_modules/` | NPM dependencies |
| `.worktrees/` | Git worktree isolation |
| `.vector_data/` | ChromaDB binary storage |
| `.git/` | Git internal metadata |
| `venv/`, `.venv/` | Python virtual environments |
| `__pycache__/` | Python bytecode cache |
| `*.json`, `*.jsonl` | Data payloads and export bundles |
| `*_packet.md`, `*_digest.md` | Machine-generated context bundles |

*Rationale:* Machine-generated files create thousands of false backlinks and pollute graph connectivity.

---

## Post-Init Verification

1. Open Obsidian -> "Open Folder as Vault" -> select vault root.
2. Verify indexing: Confirm structural folders appear in sidebar.
3. Test wikilinks: Click `[[wikilink]]` references to confirm bidirectional resolution.
4. Set environment variable: `export VAULT_PATH=/path/to/vault`.

---

## Wiki Engine Guided Discovery

After vault initialization, configure the LLM Wiki Engine source manifest (`rlm_wiki_raw_sources_manifest.json`):

### Running Discovery
```bash
python ./scripts/raw_manifest.py --init --wiki-root /path/to/wiki-root
```

### Manifest Schema
```json
{
  "description": "Source raw content for Obsidian Wiki",
  "include": [
    "plugins/",
    "docs/"
  ],
  "exclude": [
    ".git/",
    "node_modules/",
    ".venv/",
    "__pycache__/"
  ],
  "recursive": true
}
```

---

## Portability & Quick Reference

```bash
# 1. Install prerequisites
brew install --cask obsidian
npm install -g obsidian-cli
pip install ruamel.yaml

# 2. Initialize vault
python ./init_vault.py --vault-root /path/to/your/project

# 3. Export environment
export VAULT_PATH=/path/to/your/project
```
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall