Obsidian Agent Vault Template workflow
An Obsidian vault template where skills sit beside notes, decisions and feedback for Claude Code and Codex.
- 67 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The agent reads and writes vault notes, including run logs, so secrets must not be kept in it.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add workflows/obsidian-agent-vault-templateDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The agent reads and writes vault notes, including run logs, so secrets must not be kept in it.
This is third-party code. Review the repository files before installing.
What it does
The Obsidian vault template gathers everything an agent relies on into one folder: notes, decisions and skills. `AGENT-RULES.md` sets one contract for any agent: folder map, ownership, note rules and the feedback loop. `CLAUDE.md` and `AGENTS.md` only point to it, so Claude Code and Codex read the same thing. The `Skills/` directory holds four ready skills: `example-voice` as a model, `scheduled-runs`, `html-prototypes` and `vault-maintenance`. Each skill has a `FEEDBACK.md`: the agent logs what worked and what you corrected, and repeated corrections move into `SKILL.md` as a new default. The `Skills Index.md` index tells the agent what to load. Projects that span several sessions get an `index.md` and a `progress-log.md`, and a new session continues from them.
Who it is for. People who keep knowledge and workflows in Obsidian and want Claude Code, Codex or the next tool to work from the same notes and rules.
Good fit when
- Changing the model or tool must not erase rules and corrections accumulated over months.
- A new agent session must continue a project from where it stopped using two notes.
- Repeated corrections to text should become skill rules rather than being repeated by hand.
- A weekly vault check looks for orphan notes and broken links without rewriting your text.
- Several agents, including scheduled runs, must see each other's work log.
Not a fit when
- Notes are kept outside Obsidian or a folder of markdown files.
- You need one ready skill: the template brings a folder structure, rules and a log along.
- You plan to store code alongside notes: the author advises keeping it in a separate Git repository.
Example request
Load the example-voice skill from the vault, draft an email with it and log what I correct in FEEDBACK.md.Limitations
This is a file template, not a program: there is nothing to run. You fill in the folder map in section 1 of `AGENT-RULES.md` and can keep the other sections as they are. For the agent to find the vault from any folder, its path goes into `~/.claude/CLAUDE.md` and `~/.codex/AGENTS.md`. The setup with a separate always-on computer in the README is an example deployment, not a requirement. The `vault-maintenance` skill grades skills by Claude Code and Codex sessions and drafts edits for your approval. Secrets must not be committed to the vault.
How to disable. Remove the lines with the vault path from `~/.claude/CLAUDE.md` and `~/.codex/AGENTS.md`, and stop the scheduled `vault-maintenance` task if you set one. Keep or delete the vault folder, it does not depend on the agents.
FAQ
How do I install the template?
Run `git clone https://github.com/louisfb01/obsidian-agent-vault-template.git` or download the ZIP, then in Obsidian choose "Open folder as vault" and pick the folder. Nothing needs running, and every file reads as plain text.
How do I connect the vault to Claude Code and Codex?
If you start the agent inside the vault folder it loads `CLAUDE.md` or `AGENTS.md` on its own. To reach it from any folder, add the vault path and a pointer to `AGENT-RULES.md` in `~/.claude/CLAUDE.md` and `~/.codex/AGENTS.md`.
What is FEEDBACK.md?
A skill's self-improvement log. After each run the agent writes what worked and what you corrected. A repeated correction moves into `SKILL.md` as new default behavior.
How do I create my own skill?
Copy `Skills/example-voice/`, edit its `SKILL.md` and add a block for it to `Skills Index.md`. The index layers skills from grounding to voice, research and output so the agent takes only what it needs.
What does vault-maintenance do?
Weekly it refreshes hubs and links, finds orphan notes and reports where rules are not followed, without rewriting your notes. It also grades skills in recent sessions and drafts edits for your approval.
Discussion
No questions or reviews yet.
Related
WorkflowsA skill set that lets an agent run a personal Obsidian wiki: it compiles knowledge from documents and past sessions and answers with citations
An Obsidian vault template for Claude Code: /daily, /weekly, /monthly and /project commands link three-year goals to today's tasks
Obsidian skills
Obsidian Skills
Skills for agents working with Obsidian: Markdown with wikilinks, Bases, JSON Canvas, Obsidian CLI, Defuddle and Knap
An Obsidian vault template with hooks, commands and skills that gives Claude Code, Codex and Gemini CLI persistent memory across sessions
A build script and templates that turn an Obsidian vault into an AI's working memory: markdown notes, no vector database
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Obsidian Agent Vault Template (this card) | no | 67 | |
| claude-obsidian | no | 16,397 | turns Obsidian into a knowledge base for Claude; this one is a ready vault with skills, a feedback log and rules for different agents |
| obsidian-second-brain | no | 5,313 | builds a second brain with an AI-first note format; the template adds self-improving skills and vault health checks |
README in short
The repository is based on the author's working vault, stripped of personal content. It accompanies an O'Reilly talk about skills that travel with your notes.