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/wiki-builder-guide.md
View on GitHub# Obsidian Wiki Builder Guide
## Contents
- [Output Layout Specification](#output-layout-specification)
- [3-Stage Build Pipeline](#3-stage-build-pipeline)
- [Multi-Source Concept Merging](#multi-source-concept-merging)
- [Karpathy Node Markdown Schema](#karpathy-node-markdown-schema)
- [Source Manifest Schema](#source-manifest-schema)
---
## Output Layout Specification
A fully-built wiki root contains three top-level directories:
```
{wiki_root}/
wiki/
_index.md <- Master concept index
_toc.md <- Table of contents
_{cluster}.md <- Per-topic cluster page
{concept}.md <- Individual wiki node
rlm/
{concept}/
summary.md <- 1-5 sentence distilled summary
bullets.md <- Key idea bullets
deep.md <- Full multi-pass distillation
meta/
wiki_sources.json <- Raw source registry (from wiki-init)
config.yaml <- Wiki configuration settings
agent-memory.json <- State and hash tracking
```
---
## 3-Stage Build Pipeline
`wiki_builder.py` runs three sequential stages:
1. **`ingest.py`**: Scans raw source files, normalizes markdown text, and generates SHA256 hashes for staleness detection.
2. **`concept_extractor.py`**: Groups records by concept slug and merges multi-source records into authoritative concepts.
3. **Wiki Node Formatting**: Renders merged records into Karpathy-format markdown files with bidirectional wikilinks.
---
## Multi-Source Concept Merging
When multiple source files yield the same concept slug, the compiler merges them into one authoritative node:
- Merges content with source attribution headers.
- Records all originating files in `source_files` frontmatter array.
- Recalculates topic cluster from combined keyword density.
- Flags `multi_source: true` for downstream audits.
---
## Karpathy Node Markdown Schema
```markdown
---
concept: {concept_name}
source: {source_label}
source_file: {relative_path}
wiki_root: {wiki_root}
generated_at: {timestamp}
cluster: {cluster_name}
---
# {Concept Name}
{1-sentence RLM summary}
## Key Ideas
- {bullet_1}
- {bullet_2}
## Details
{full_content}
## See Also
- [[{related_concept_1}]]
- [[{related_concept_2}]]
## Raw Source
- `{source_label}` -> `{source_file}`
```
---
## Source Manifest Schema
Location: `.agent/learning/rlm_wiki_raw_sources_manifest.json`
```json
{
"namespace": "project-name",
"wiki_root": "/path/to/wiki-root",
"sources": {
"arch-docs": {
"path": "/path/to/docs",
"label": "arch-docs",
"extensions": [".md"],
"excludes": ["_archive"],
"description": "Architecture records"
}
},
"global_excludes": ["_archive", "*.tmp", "__pycache__"]
}
```
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 |