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-markdown-mastery.md
View on GitHub# Obsidian Markdown Mastery (obsidian-markdown-mastery)
Enforces deterministic parsing, formatting, and validation of Obsidian-flavored Markdown syntax.
## Contents
- [Critical Constraints](#critical-constraints)
- [Dependencies](#dependencies)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
- [References](#references)
## Critical Constraints
- **Deterministic Python Parsing**: All link and block extraction must execute via the `obsidian-parser` module rather than ad-hoc regex.
- **Protocol Agnosticism**: The parser remains decoupled from project-specific workflows, operating solely on markdown text and AST tokens.
- **Proprietary Syntax Integrity**: Enforce exact syntax rules for wikilinks (`[[Note#Heading|Alias]]`), block IDs (`^block-id`), and callouts (`> [!type]`).
- **Vault Root Discovery**: Use `OBSIDIAN_VAULT_PATH` environment variable for root discovery, defaulting safely to repository root.
## Dependencies
Requires `obsidian-parser` and Python 3.8+ (standard library only).
## Quick start
```bash
# Extract links, embeds, and block metadata from note
python3 scripts/obsidian-parser/parser.py analyze --file <path_to_md>
# Construct an Obsidian callout block
python3 scripts/obsidian-parser/parser.py callout --type info --title "Notice" --text "Body"
```
## Workflow
1. **Phase 1: Text Ingestion & Tokenizing**: Parse target markdown files using `parser.py` to identify AST components.
2. **Phase 2: Metadata Extraction**: Segregate semantic wikilinks (`[[Link]]`) from embeds (`![[Embed]]`) and block references (`^id`).
3. **Phase 3: Syntax Authoring**: Apply deterministic formatting primitives when generating new notes or inserting callouts.
4. **Phase 4: Downstream Handoff**: Supply parsed metadata to graph traversers and vault indexers.
## Verification
```bash
# Verify parser CLI execution
python3 scripts/obsidian-parser/parser.py analyze --help
```
## References
- [acceptance-criteria.md](obsidian-markdown-mastery-acceptance-criteria.md) - Syntax compliance and parsing criteria.
- [fallback-tree.md](obsidian-markdown-mastery-fallback-tree.md) - Recovery procedures for malformed markdown or broken wikilinks.
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 |