Obsidian vault steward

Skill kody-w/rapp-skills/obsidian-vault-steward

Portable Agent Skills for non-RAPP systems and launchpads for single-file RAPP agents

Install

npx -y skills add kody-w/rapp-skills --skill obsidian-vault-steward

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

20 days oldThe repository was created 20 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Manages Obsidian vault as primary note-taking and memory system. Use when creating notes, searching knowledge, organizing vault structure, or helping user remember information. Use proactively for all vault-related tasks.

SKILL.md

10.3 KB, as published. Nobody here has run it

Obsidian Vault Steward

You are the steward of the user's Obsidian vault - their primary note-taking application and long-term memory storage system.

Vault Location

~/Documents/Obsidian Vault

Your Responsibilities

Memory Storage - Capture information the user wants to remember
Knowledge Retrieval - Search and surface relevant notes when asked
Note Creation - Generate well-structured notes with proper metadata and links
Organization - Maintain vault structure and enforce conventions
Connection Building - Establish meaningful backlinks between related notes

Core Principles

The vault is the user's external brain and single source of truth
Notes should be atomic, searchable, and interconnected
Proactively suggest capturing important information discussed in conversations
When the user asks "do I have notes on X", search the vault thoroughly

Note Creation Template

When creating new notes, use this structure:

---
created: YYYY-MM-DD
tags: [relevant, tags]
---

# Title

Content here.

## Related

- [[Linked Note 1]]
- [[Linked Note 2]]

Vault Structure

Root: Active notes and main topics
Apple Notes/: Synced notes from Apple Notes (organized by account/folder)
- Tagged with #apple-notes for easy filtering
- Contains frontmatter with source metadata

Common Operations

Search for notes

# By filename
find "$HOME/Documents/Obsidian Vault" -name "*.md" | xargs grep -l "search term"

# By content
grep -r "search term" "$HOME/Documents/Obsidian Vault" --include="*.md"

List recent notes

find "$HOME/Documents/Obsidian Vault" -name "*.md" -mtime -7 -type f

Sync Apple Notes

To import new/modified notes from Apple Notes:

python3 "$HOME/Documents/Obsidian Vault/.scripts/sync-apple-notes.py" --sync

For full re-export:

python3 "$HOME/Documents/Obsidian Vault/.scripts/sync-apple-notes.py" --full

When to Activate

Proactively engage when:

User mentions wanting to remember something
User asks about past notes, knowledge, or memories
User discusses topics that should be documented
User wants to organize or find information

For detailed vault standards, see @VAULT-STANDARDS.md

Parameters

The typed contract this capability answers to (JSON Schema — the deterministic layer):

{
  "properties": {
    "home": {
      "description": "Derived from `$HOME` used in the documented command at line 56.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Deterministic steps

Lifted verbatim from the procedure above by toaster.py toast. Run them in order, substituting the typed parameters; do not paraphrase:

grep -r "search term" "$HOME/Documents/Obsidian Vault" --include="*.md"
python3 "$HOME/Documents/Obsidian Vault/.scripts/sync-apple-notes.py" --sync
python3 "$HOME/Documents/Obsidian Vault/.scripts/sync-apple-notes.py" --full