agentsclimarketplace

Obsidian brain

Skill jiahao-shao1/sjh-skills/skills/obsidian-brain

Obsidian Second Brain (dual-zone vault) Claude Code integration. Use for loading project context, capturing thoughts, morning planning, querying linked notes. Triggers: 'obsidian', 'second brain', 'vault', 'capture thought', 'today plan', '第二大脑', '今日计划', '记录想法'. Not for Notion (use notion-lifeos) or papers (use scholar-agent).From its SKILL.md

Install
npx -y skills add jiahao-shao1/sjh-skills --skill obsidian-brain

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

4.2 KB, as published. Nobody here has run it

Obsidian Brain

A thinking partner skill that integrates Claude Code with your Obsidian vault.

Setup

If the vault doesn't exist yet, initialize it:

scripts/init-vault.sh ~/second-brain

The vault path defaults to ~/second-brain. Set VAULT_ROOT environment variable to override.

Core Principle: Dual-Zone Architecture

The vault has two zones. You MUST respect these boundaries:

Human Zone (read-only for AI, with exceptions)

Directories: notes/, projects/, tasks/, resources/, contexts/, daily/, people/

NEVER directly create or modify files in these directories — unless using scripts/human-write.sh for user-dictated content (tasks, notes). Human-write validates the path is in tasks/ or notes/ AND the content has source: human.

AI Zone (read-write for AI)

Directory: ops/ (and all subdirectories)

All AI-generated writes MUST go through scripts/safe-write.sh which validates paths via realpath. Direct file writes to the vault are forbidden.

Commands

CRUD Commands

/capture

Capture user's words as a draft. Run scripts/capture.sh.

Zone: Writes to ops/drafts/ only (via safe-write.sh).

Create Task

Create a task the user dictates. Run scripts/create-task.sh.

scripts/create-task.sh $VAULT_ROOT "Task title" --due 2026-04-01 --tags "work,urgent"

Zone: Writes to tasks/ only (via human-write.sh, source: human).

Create Note

Create a note the user dictates. Run scripts/create-note.sh.

scripts/create-note.sh $VAULT_ROOT "Note title" "Content text" --tags "ai" --links "concept-a,concept-b"

Zone: Writes to notes/ only (via human-write.sh, source: human).

Query Tasks

Query tasks with filtering. Run scripts/query-tasks.sh.

scripts/query-tasks.sh $VAULT_ROOT --undone --date today
scripts/query-tasks.sh $VAULT_ROOT --tag migration --project obsidian-brain

Zone: Reads only.

Complete Task

Mark a task as done. Run scripts/complete-task.sh.

scripts/complete-task.sh $VAULT_ROOT "task keyword"

Zone: Modifies done: field in tasks/ only.

Planning Commands

/context

Load project context from the vault. Read references/command-guide.md for details.

Zone: Reads both zones. Never writes.

/today

Morning planning. Read tasks, recent daily notes, and calendar.

Zone: Reads both zones. Output to terminal only — never writes.

Reflection Commands (Phase 2)

All reflection commands output to terminal only — they never write files.

/challenge

Stress-test a belief against your past writing.

scripts/analyze.sh $VAULT_ROOT --mode challenge --topic "some belief"

Zone: Reads human zone only.

/drift

Detect gaps between intended goals and actual activity.

scripts/analyze.sh $VAULT_ROOT --mode drift --days 60

Zone: Reads human zone only.

/emerge

Surface hidden ideas — ghost links and recurring themes.

scripts/analyze.sh $VAULT_ROOT --mode emerge --days 30

Zone: Reads human zone only.

/connect

Find hidden connections between two topics.

scripts/analyze.sh $VAULT_ROOT --mode connect --topics "topic-a,topic-b"

Zone: Reads human zone only.

Wikilink Queries

Use scripts/query-links.sh to find connected notes:

# Find what a note links to
scripts/query-links.sh $VAULT_ROOT outgoing "notes/idea-a.md"

# Find what links to a topic
scripts/query-links.sh $VAULT_ROOT backlinks "idea-a"

# Backlinks from human zone only (for reflection commands)
scripts/query-links.sh $VAULT_ROOT backlinks "idea-a" --human-only

Schema Reference

See references/vault-schema.md for frontmatter conventions, zone rules, and wikilink strategy.

See references/command-guide.md for detailed command documentation.

Keep looking

Skills are one crate of 614,496. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.