Skip to content

obsidian: add a vault starter pack; agents: remove unused skills - #20

Merged
krishna-bala merged 6 commits into
mainfrom
krishna.obsidian.add-work-vault-seed
Sep 23, 2026
Merged

krishna-bala merged 6 commits into
mainfrom
krishna.obsidian.add-work-vault-seed

Conversation

@krishna-bala

@krishna-bala krishna-bala commented Sep 23, 2026 •

Copy link
Copy Markdown
Owner

Summary

  1. Add an obsidian module: a starter pack for new Obsidian vaults, applied with modules/obsidian/seed-vault <vault-path>.
  2. Remove the generate-notes, improve-notes, optimize and tiling-tree skills from modules/agents, leaving vault as the only shared skill, and note that a root AGENTS.md is enough for Claude Code.

obsidian module

seed-vault:

  • creates Projects/, Knowledge/, Archive/, Templates/, _Inbox/ and .claude/skills/
  • resets the pack's .obsidian settings (appearance, hotkeys, core and community plugin lists, the line-spacing snippet, per-plugin data.json) and the vimrc
  • copies a starter AGENTS.md, Home.md and .gitignore
  • runs git init with no remote

Files are copied rather than linked. On an existing vault, each settings file that differs is backed up to ~/.local/state/seed-vault/ and replaced; AGENTS.md, Home.md and .gitignore are only added when missing. The script refuses to run while Obsidian is open. After seeding, each vault owns its copy and may drift. The module is in no role; README.md and CLAUDE.md now describe this kind of hand-run module. modules/obsidian/README.md covers the steps inside Obsidian (plugins by display name, the Catppuccin theme, fonts).

Relative to the personal vault's config: hotkeys and vimrc mappings for plugins that are off or not installed are dropped, the Calendar plugin is removed, style settings keep only Catppuccin entries, DataviewJS is off, dates are YYYY-MM-DD everywhere, and indentation uses spaces (useTab: false) to match nvim and prettier.

Skill cleanup

The removed skills are no longer used, and three of them hard-coded paths into the notes vault. Machines that ran ./install before this change keep dangling links under ~/.claude/skills/ and ~/.agents/skills/ until they are removed by hand.

Testing

  • seed-vault against a scratch directory: layout, config and starter files created, all JSON valid, git initialised with no remote.
  • Re-run: only [skip] lines, nothing changed.
  • Existing vault with differing app.json and community-plugins.json: both backed up and replaced, workspace.json and an existing AGENTS.md left alone.
  • shellcheck -S warning passes.
  • Not yet tested end to end in Obsidian. The Date Inserter settings were checked against the plugin code: it rebuilds its format specs from the top-level format (yyyy-mm-dd) on first load.

🤖 Generated with Claude Code

Add an obsidian module holding the Obsidian settings shared across
vaults (Catppuccin appearance, hotkeys, vimrc, line-spacing snippet,
per-plugin settings) and starter content for a new vault: AGENTS.md,
Home.md, a gitignore, and meeting, project, person and design-note
templates.

seed-vault <path> copies these into a vault without overwriting
anything, creates the concepts/projects/references/archive layout, and
runs git init with no remote. It is listed in no role, since a vault
path is chosen per machine and Obsidian rewrites its own JSON, so
linking the files would push per-vault changes back into this repo.

Compared with the personal vault, the copied config drops hotkeys for
plugins that are not installed, keeps style settings for Catppuccin
only, turns off DataviewJS, and sends attachments to attachments/.
Drop generate-notes, improve-notes, optimize and tiling-tree, which are
no longer used. The first three hard-coded paths into a specific notes
vault layout. Also remove the README's provenance note pointing at the
plugin repo they were migrated from, which is no longer maintained
here.

vault is now the only shared skill.
Claude Code reads AGENTS.md when a directory has no CLAUDE.md, so a
project with only a root AGENTS.md needs no CLAUDE.md shim. Its Claude
skills still go in .claude/skills/, since Claude does not read
.agents/skills/.
Review follow-ups on seed-vault:

- Drop the work-vault wording and the meeting, project, person and
  design-note templates. AGENTS.md now describes a general vault that
  starts local with no remote.
- Remove the Calendar plugin, which needs core Daily Notes (off), and the
  vimrc mappings that called daily notes, opened File Recovery under the
  name "recent", or were never bound.
- Use YYYY-MM-DD in Datepicker, Date Inserter and Dataview.
- Home.md finds projects by type instead of folder, so notes still in
  _inbox/ show up, and lists the inbox and recent edits.
- Drop the [!definition] and [!theorem] callouts from AGENTS.md (no
  theme styles them), fix the command palette key (Ctrl+P), and tell
  agents to expand Templater tags themselves.
- Add a module README listing the plugins by their display names, the
  theme, and how to install the Google Sans fonts. seed-vault now points
  there instead of printing a multi-line log.
- Document hand-run modules in README.md and CLAUDE.md.
@krishna-bala
krishna-bala force-pushed the krishna.obsidian.add-work-vault-seed branch from 1581c49 to fc8e951 Compare September 23, 2026 19:46
@krishna-bala krishna-bala changed the title obsidian: add seed-vault for local-only vaults; agents: remove unused skills obsidian: add a vault starter pack; agents: remove unused skills Sep 23, 2026
Obsidian defaults to tabs, while nvim (expandtab) and prettier indent
markdown with spaces, so saving an Obsidian-edited note in nvim
rewrote every tab-indented list. Turn off "Indent using tabs" so both
editors write the same 2-space indents.
- AGENTS.md: Home.md lists projects that are not complete, matching
  its query.
- vimrc: drop the toggleCheckbox and toggleCode exmaps, which were
  never bound.
- README: say "turn off Restricted mode" instead of the ambiguous
  "leave Restricted mode".
@krishna-bala
krishna-bala force-pushed the krishna.obsidian.add-work-vault-seed branch 2 times, most recently from 0434bd2 to 646b524 Compare September 23, 2026 20:36
@krishna-bala
krishna-bala merged commit fc25613 into main Sep 23, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant