onboarding

Configure OneBrain for an Obsidian vault by collecting preferences and writing configuration files.

23|2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/onebrain-ai/onebrain --skill onboarding-onebrain-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: onboarding
Source: https://github.com/onebrain-ai/onebrain/tree/main/.claude/plugins/onebrain/skills/onboarding
Command: npx skills add https://github.com/onebrain-ai/onebrain --skill onboarding-onebrain-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of getting OneBrain configured correctly on first install so the agent has the right identity, preferences, and vault structure before you start using it.

Core Features & Use Cases

  • First-run vault personalization: Collects user identity and agent personality settings (name, role, communication style, detail level, tone, and goals) to generate a tailored 05-agent/MEMORY.md.
  • Deterministic vault bootstrapping: Creates the required Obsidian folder layout (inbox, projects, areas, knowledge, resources, agent, archive, logs, and attachments) and writes onebrain.yml.
  • Safe re-run + existing vault adoption: Detects whether OneBrain is already present to prevent destructive changes, or adopts plugin files from the global cache for existing vaults without overwriting user data.

Quick Start

Run onboarding once in a fresh OneBrain setup: "Start /onboarding and answer the personalization questions so OneBrain generates MEMORY.md and onebrain.yml."

Frequently Asked Questions about onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up persistent memory for my Obsidian vault?▼

Persistent memory setup involves collecting your identity and preferences to generate a tailored MEMORY.md and onebrain.yml, establishing the required Obsidian vault structure.

What is the best way to configure agent identity and preferences in Obsidian?▼

Agent configuration uses interactive questioning to gather your name, role, and goals, then writes these inputs deterministically into persistent configuration files for the vault.

Can I run vault bootstrapping on an existing Obsidian setup without losing notes?▼

Vault bootstrapping safely adopts existing setups by detecting current configurations, preventing destructive changes, and avoiding overwrites to MEMORY.md when it already exists.

Does OneBrain onboarding require manually creating folders before starting?▼

No, onboarding does not require manual folder creation; it deterministically bootstraps the required Obsidian folder layout, including inbox, projects, areas, knowledge, and archives automatically.

What happens if I re-run the onboarding configuration process?▼

Re-running the onboarding configuration is safe; it preserves your existing notes and avoids overwriting MEMORY.md, applying guardrails to prevent destructive changes to your vault.

Why do I need a onebrain.yml file in my Obsidian vault?▼

You need a onebrain.yml file to store deterministic configuration data and plugin-cache adoption settings, ensuring the agent has the correct structural foundation before use.