A collection of skills that turn an AI assistant into a personal vault manager for Obsidian — your long-term second brain.
This project gives your AI assistant the ability to actively help you manage your Obsidian vault — creating notes, organizing content, remembering your preferences, and syncing your vault to git — all without you lifting a finger.
Works with any PKM method: PARA, Zettelkasten, LYT, or your own custom setup.
- Obsidian installed with an existing vault
- An AI assistant that supports skills/tools and has access to your local filesystem
- uv (for git sync service only)
Add this skill to your assistant:
npx skills add github.com/kilip/second-brainOn your first session, the assistant will run a short setup interview to learn your name, preferences, and vault structure. This only happens once.
That's it — your assistant is ready.
| Skill | What it does |
|---|---|
| memory-management | Gives the assistant persistent memory across sessions — who you are, how you work, and a full log of every action taken in your vault |
| install-service | Installs background services and scheduled jobs on Linux, macOS, or Windows |
The core skill. On first run, the assistant will:
- Scan your vault structure and detect your PKM setup
- Ask you a few short questions (name, language, preferences)
- Start logging every action it takes
After that, it loads your profile automatically at the start of every session.
What gets stored:
.agents/
memory/
USER.md ← your preferences & shorthand
SOUL.md ← how the assistant behaves in your vault
DEVICE.md ← vault path & system info
logs/ ← daily action logs
Keeps your vault automatically backed up to a git remote (GitHub, GitLab, etc.).
Watches for file changes → commits → pushes. Runs in the background as a system service.
Quick setup:
# 1. Make sure your vault has a git remote set up
git -C ~/your-vault remote add origin https://github.com/you/vault.git
# 2. Install the sync service
uv run skills/install-service/git-sync.py --install --vault ~/your-vaultWorks on Linux (systemd), macOS (launchd), and Windows (Task Scheduler).
MIT License © Anthonius 2026-present