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
---
name: managing-obsidian-vaults
plugin: agent-memory
description: >
  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.
allowed-tools: Bash, Read, Write
---

# 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](#interaction) · [Constraints](#constraints) · [Workflow](#workflow) · [Quick start](#quick-start) · [Verification](#verification)

## Interaction
Treat slash-invocation arguments as supplied requirements; do not ask for them again.

For vault/wiki setup, read [guided setup](references/interactive-setup.md); for combined layers,
read [Super-RAG setup](references/interactive-stack-setup.md), 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 emits `summary.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](references/obsidian-init.md), [onboarding](references/obsidian-vault-onboarding-guide.md) |
| Markdown, wikilinks, embeds, callouts | [Markdown](references/obsidian-markdown-mastery.md) |
| Read/create/update/append notes | [Note operations](references/obsidian-vault-crud.md) |
| Read/update Base rows and cells | [Bases](references/obsidian-bases-manager.md) |
| Create/edit Canvas nodes and edges | [Canvas](references/obsidian-canvas-architect.md) |
| Forward/backlinks, orphans, graph | [Traversal](references/obsidian-graph-traversal.md) |
| Build/synthesize concept wiki | [Build](references/obsidian-wiki-builder.md), [guide](references/wiki-builder-guide.md) |
| Distill wiki's three summary layers | [Distill](references/obsidian-rlm-distiller.md), [guide](references/wiki-distillation-guide.md) |
| Query summaries, bullets or full nodes | [Query](references/obsidian-query-agent.md), [guide](references/wiki-query-guide.md) |
| Structural audit / semantic lint | [Lint](references/obsidian-wiki-linter.md), [guide](references/wiki-linting-guide.md) |

## Quick start

```bash
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](references/obsidian-bases-manager-acceptance-criteria.md) · [obsidian-bases-manager recovery](references/obsidian-bases-manager-fallback-tree.md) · [obsidian-canvas-architect criteria](references/obsidian-canvas-architect-acceptance-criteria.md) · [obsidian-canvas-architect recovery](references/obsidian-canvas-architect-fallback-tree.md) · [obsidian-graph-traversal criteria](references/obsidian-graph-traversal-acceptance-criteria.md) · [obsidian-graph-traversal recovery](references/obsidian-graph-traversal-fallback-tree.md) · [obsidian-init criteria](references/obsidian-init-acceptance-criteria.md) · [obsidian-init recovery](references/obsidian-init-fallback-tree.md) · [obsidian-markdown-mastery criteria](references/obsidian-markdown-mastery-acceptance-criteria.md) · [obsidian-markdown-mastery recovery](references/obsidian-markdown-mastery-fallback-tree.md) · [obsidian-vault-crud criteria](references/obsidian-vault-crud-acceptance-criteria.md) · [obsidian-vault-crud recovery](references/obsidian-vault-crud-fallback-tree.md)

Follow the [acceptance contract](references/acceptance-criteria.md); browse the [resource index](references/resource-index.md). Supplemental: [architecture-background](references/architecture-background.md) · [kepano-analysis-summary](references/kepano-analysis-summary.md) · [safety-learnings](references/safety-learnings.md) · [dependencies](references/dependencies.md) · [wiki-node.template](references/../assets/templates/wiki-node.template.md).
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