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.
Managing Obsidian Vaults
Read the matching workflow before acting. Run commands from this skill's folder.
Use explicit vault/wiki roots; set AGENT_MEMORY_PROJECT_ROOT for the consumer project.
Contents
Interaction · Constraints · Workflow · Quick start · Verification
Interaction
Treat slash-invocation arguments as supplied requirements; do not ask for them again.
For vault/wiki setup, read guided setup; for combined layers, read Super-RAG setup, including when wiki is not selected. Run the conversation here: reuse known choices, ask one unresolved question per turn, preview changes, merge existing config and validate only selected layers. Continue sibling skill modes inline with shared answers and scope; never launch a setup agent. Explicit note/query operations go directly to their modes.
Constraints
- Never move raw source content. Confirm external directory scans before discovery.
- Preview initialization with
--validate-only; preserve existing project configuration. - Notes/Bases require lossless YAML, staged atomic writes, locking and concurrent-edit checks.
- Preserve Base view definitions. Validate Canvas nodes/edges and generate unique IDs.
- Distinguish links from embeds; graph traversal is read-only and respects cache invalidation.
- Merge multi-source concepts; preserve node frontmatter, raw-source manifests and
meta/agent-memory.json. Wiki distillation emitssummary.md,bullets.md,deep.md. - Start queries at summary level, expand only as needed. Lint writes reports, not concept edits.
- Use configured low-cost cloud CLIs for wiki distillation/lint; never silently use local models.
- Vector retrieval is optional: explicitly supply its query script through
AGENT_MEMORY_VECTOR_QUERY, or delegate to managing-vector-db if installed.
Workflow
| Request | Read first |
|---|---|
| Initialize vault / register sources | Setup, onboarding |
| Markdown, wikilinks, embeds, callouts | Markdown |
| Read/create/update/append notes | Note operations |
| Read/update Base rows and cells | Bases |
| Create/edit Canvas nodes and edges | Canvas |
| Forward/backlinks, orphans, graph | Traversal |
| Build/synthesize concept wiki | Build, guide |
| Distill wiki's three summary layers | Distill, guide |
| Query summaries, bullets or full nodes | Query, guide |
| Structural audit / semantic lint | Lint, guide |
Quick start
python3 scripts/init_vault.py --vault-root /path/to/vault --validate-only
python3 scripts/wiki_builder.py --wiki-root /path/to/wiki --dry-run
python3 scripts/distill_wiki.py --wiki-root /path/to/wiki --dry-run
python3 scripts/query_wiki.py --wiki-root /path/to/wiki "concept" --level summary
python3 scripts/lint_wiki.py --wiki-root /path/to/wiki --dry-run
Verification
Validate changed notes, Canvas schemas and preserved frontmatter. Run structural
wiki audit with python3 scripts/audit.py --wiki-root /path/to/wiki.
Wiki build/query and vault operations work without RLM/vector sibling skills.
For combined setup, follow the interactive stack guide in this session after checking selected skills.
Install dependencies from this skill's lockfile only within the authorized setup scope.
obsidian-bases-manager criteria · obsidian-bases-manager recovery · obsidian-canvas-architect criteria · obsidian-canvas-architect recovery · obsidian-graph-traversal criteria · obsidian-graph-traversal recovery · obsidian-init criteria · obsidian-init recovery · obsidian-markdown-mastery criteria · obsidian-markdown-mastery recovery · obsidian-vault-crud criteria · obsidian-vault-crud recovery
Follow the acceptance contract; browse the resource index. Supplemental: architecture-background · kepano-analysis-summary · safety-learnings · dependencies · wiki-node.template.
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 |