Skip to content
Automation
Skill

/obsidian-ai-setup

USE WHEN the user runs `/obsidian-ai-setup` or asks to set up their vault, bootstrap the assistant, initialize the system, or configure the AI Pro Obsidian Plugin.

From plugin
obsidian-ai-setup
241 skill
Install
$ npx -y skills add anliberant/obsidian-ai-setup --skill obsidian-ai-setup --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/obsidian-ai-setup

Context preview

The summary Claude sees to decide when to auto-load this skill.

USE WHEN the user runs `/obsidian-ai-setup` or asks to set up their vault, bootstrap the assistant, initialize the system, or configure the AI Pro Obsidian Plugin.

SKILL.md

obsidian-ai-setup.SKILL.md
name: obsidian-ai-setup
description:
  Bootstrap an Obsidian vault with the AI Pro Obsidian Plugin. Creates the complete vault structure,
  system files, Obsidian configuration, memory system, hooks, and output styles, then runs
  personalized onboarding to tailor the workspace to the user. Uses a single universal structure
  with no mode selection. Trigger when the user says "set up", "bootstrap", "initialize",
  "onboarding", or runs `/obsidian-ai-setup`.

AI Pro Obsidian Plugin — Setup + Onboarding

USE WHEN the user runs `/obsidian-ai-setup` or asks to set up their vault, bootstrap the assistant, initialize the system, or configure the AI Pro Obsidian Plugin.

> [!important] User-facing language This skill is fully in English. Everything the user sees must be > in English: orientation messages, form headings, bullet prompts in Phase B, the final Phase B+ > question, confirmations, and summaries. > > Internal instructions in this `SKILL.md` and technical values such as file names, frontmatter > keys, `os-mode`, and slugs must remain as written.

> [!note] One universal mode This skill builds **one universal structure** — there is no "individual > / company" mode selection. The base is a lightweight professional structure (`Context`, > `Projects`, `Daily`, `Resources`, `Skills`, `Intelligence`) that works equally well for a solo > operator or a small team. Do not create `Departments/`, `Team/{org}/Profiles/`, or separate > business templates. `os-mode` is always `professional`.

This is a two-phase process:

  • **Phase A**: Bootstrap — Create the universal directory structure and system files
  • **Phase B**: Onboarding — Interview the user and personalize everything

Pre-flight Check

Check if `claude.md` or `CLAUDE.md` exists **only** in the current working directory. Do NOT search subdirectories or parent directories. Check only the exact current working directory path.

  • **If it exists**: The vault is already set up. Ask the user:
  • Question: `This vault is already configured. What would you like to do?`
  • **`Restart onboarding`** — `Keep the structure and update files using new answers`
  • **`Full reset`** — `Delete everything and start from scratch (confirm twice before deleting)`
  • **`Cancel`** — `Do nothing`
  • **If it does NOT exist**: Proceed with full setup (Phase A + Phase B)

> [!note] No mode selection There used to be a Phase 0 for choosing "individual / company" mode. It > has been removed. The structure is always universal (`os-mode: professional`). Go directly to > Phase A. Do not ask about a mode.

---

Phase A: Bootstrap

Create the universal directory structure and write all system files. There is one structure — always `os-mode: professional`.

Resolving reference file paths

Every `references/<file>.md` mentioned below lives in the `references/` subdirectory next to **this SKILL.md** — not in the user's working directory. Two conventions matter:

  • **Read paths** (`references/foo.md`) → resolve relative to this SKILL.md's directory.
  • **Write paths** (`./Foo/CLAUDE.md`) → resolve relative to the user's current working directory

(the vault root).

If the Read tool cannot open a `references/...` path directly because some harnesses mount the skill at a path that differs between Read and Bash, run a quick discovery step **once** before Step A.2:

# Find the references directory; cache the result for the rest of Phase A.
find / -type d -path '*obsidian-ai-setup/references' 2>/dev/null | head -1

Use that absolute path as the prefix for every reference read in Phase A and Phase B. Do not retry path resolution per file. Resolve once and reuse.

Step A.1: Create Directory Structure

One universal structure for everyone:

mkdir -p .claude
mkdir -p Context
mkdir -p Projects
mkdir -p Daily
mkdir -p Resources
mkdir -p Skills
mkdir -p Intelligence/meetings/team-standups
mkdir -p Intelligence/meetings/client-calls
mkdir -p Intelligence/meetings/one-on-ones
mkdir -p Intelligence/meetings/general
mkdir -p Intelligence/competitors
mkdir -p Intelligence/market
mkdir -p Intelligence/decisions
mkdir -p Intelligence/archive

No `Departments/`, no `Team/`, no `Onboarding/` — those were business-mode folders and are no longer used.

Step A.2: Write System Files from References

Read each reference file and write it to the corresponding local path. The reference files contain the complete content for each system file.

**Shared system files:**

| Reference File | Creates at Local Path | | -------------------------------------- | ------------------------- | | `references/settings-json-template.md` | `./.claude/settings.json` | | `references/claudeignore-template.md` | `./.claudeignore` | | `references/gitignore-template.md` | `./.gitignore` |

**Root CLAUDE.md template:**

| Reference File | Creates at Local Path | | ---------------------------------- | --------------------- | | `references/claude-md-template.md` | `./CLAUDE.md` |

**Per-folder routing indexes** (every major folder gets its own `CLAUDE.md` — this matches the production vault convention):

| Reference File | Creates at Local Path | | -------------------------------------- | -------------------------- | | `references/claude-md-context.md` | `./Context/CLAUDE.md` | | `references/claude-md-projects.md` | `./Projects/CLAUDE.md` | | `references/claude-md-daily.md` | `./Daily/CLAUDE.md` | | `references/claude-md-intelligence.md` | `./Intelligence/CLAUDE.md` | | `references/claude-md-resources.md` | `./Resources/CLAUDE.md` | | `references/claude-md-skills.md` | `./Skills/CLAUDE.md` |

For each row: read the reference file, then write its content to the local path.

Step A.3: Initialize Starter Context Files

**Do NOT create placeholder skills.** The `Skills/` folder is created empty, with only its `CLAUDE.md` r

Read more
Ships withobsidian-ai-setup

Bootstrap a fully personalized Obsidian vault with a single command. Obsidian AI Setup is an open-source onboarding system that transforms an empty Obsidian vault into a structured AI-ready knowledge base.

Get the whole plugin
Stats
24
Stars
2
Forks
Maintained
Maintenance
2mo ago
Last commit
2mo ago
Created

Repo: anliberant/obsidian-ai-setup