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-bases-manager.md
View on GitHub# Obsidian Bases Manager (obsidian-bases-manager)
Reads and manipulates Obsidian Bases (`.base`) YAML-driven database views inside the vault.
## Contents
- [Critical Constraints](#critical-constraints)
- [Dependencies](#dependencies)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
- [References](#references)
## Critical Constraints
- **View Configuration Immutability**: Never alter or corrupt view definitions (columns, filters, sorts, formulas); mutate row and cell data only.
- **Lossless YAML Handling**: Employ `ruamel.yaml` for round-trip parsing to preserve comments, indentation, and structure.
- **Atomic Writes**: All write operations must follow the `.agent-tmp` staging and POSIX `os.rename()` atomic replacement protocol.
- **Error Guarding**: Malformed YAML must trigger informative diagnostics rather than crashing or truncating files.
## Dependencies
Requires `ruamel.yaml` and Python 3.8+ for round-trip YAML persistence.
## Quick start
```bash
# Read a Base view file
python3 scripts/bases_ops.py read --file <path.base>
# Append a row to a Base view
python3 scripts/bases_ops.py append-row --file <path.base> --data key1=value1 key2=value2
# Update a cell in a Base view
python3 scripts/bases_ops.py update-cell --file <path.base> --row-index 0 --column key1 --value "new value"
```
## Workflow
1. **Phase 1: Base Inspection**: Read the target `.base` file, validating YAML structure and active view definitions.
2. **Phase 2: Lossless Data Mutation**: Apply row append or cell update operations using `ruamel.yaml` parser.
3. **Phase 3: Atomic Persistence**: Write to staging `.agent-tmp` file and atomically rename over destination.
4. **Phase 4: Integrity Verification**: Confirm that column definitions, formulas, and filters remain intact.
## Verification
```bash
# Verify base reading operation
python3 scripts/bases_ops.py read --file <path.base>
```
## References
- [acceptance-criteria.md](obsidian-bases-manager-acceptance-criteria.md) - Bases manager invariants and test criteria.
- [fallback-tree.md](obsidian-bases-manager-fallback-tree.md) - Recovery procedures for YAML parsing and file write failures.
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 |