Skip to content
SkillScript-led21,296 tokens in use

obsidian-second-brain

Run an Obsidian vault as a self-rewriting second brain: 49 commands to save, ingest, reconcile and research, plus scheduled agents that maintain the vault overnight.

5,399 stars on the repository MIT Licenseeugeniughelbur/obsidian-second-brain

Skill label

measured from its files

What installing obsidian-second-brain costs

290tokens idle
21,296tokens in use
66,501tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: adapters/agent-skills/adapter.sh, adapters/claude-code/adapter.sh, adapters/codex-cli/adapter.sh, adapters/gemini-cli/adapter.sh, adapters/grok-bot/adapter.sh, adapters/hermes/adapter.sh, adapters/lib.sh, adapters/opencode/adapter.sh, adapters/pi/adapter.sh, hooks/load_vault_context.py, hooks/load_vault_context.sh, hooks/obsidian-bg-agent.sh, hooks/obsidian-hermes-session-end.sh, hooks/obsidian-recall.py, hooks/validate-ai-first.sh, install.sh, integrations/obsidian-mcp-server/live_test.py, integrations/obsidian-mcp-server/server.py, integrations/obsidian-mcp-server/vault_ops.py, integrations/obsidian-plugin/esbuild.config.mjs, integrations/obsidian-plugin/src/lint.ts, integrations/obsidian-plugin/src/main.ts, integrations/telegram-journal/setup.sh, integrations/telegram-journal/telegram_journal.py, scripts/architect_scan.py, scripts/bootstrap_vault.py, scripts/build.sh, scripts/build_site.py, scripts/check_notes.py, scripts/checkin.py, scripts/conformance_report.py, scripts/crew.py, scripts/document_to_pdf.py, scripts/eval/behavior_eval.py, scripts/eval/corpus.py, scripts/eval/diagnose.py, scripts/eval/retrieval_eval.py, scripts/eval/semantic_search.py, scripts/export_okf.py, scripts/freshness_lint.py, scripts/heal_links.py, scripts/ingest_batch.py, scripts/install-codex-wrappers.sh, scripts/lib.sh, scripts/link_graph.py, scripts/merge_notes.py, scripts/migrate_log.py, scripts/mine_commit_decisions.py, scripts/note_io.py, scripts/osb_env.py, scripts/platform-home.sh, scripts/python-interpreter.sh, scripts/quick-install.sh, scripts/research/__init__.py, scripts/research/lib/__init__.py, scripts/research/lib/aggregator.py, scripts/research/lib/cache.py, scripts/research/lib/config.py, scripts/research/lib/gemini.py, scripts/research/lib/gpt.py, scripts/research/lib/grok.py, scripts/research/lib/groq.py, scripts/research/lib/http.py, scripts/research/lib/perplexity.py, scripts/research/lib/podcast.py, scripts/research/lib/result.py, scripts/research/lib/source_config.py, scripts/research/lib/sources/__init__.py, scripts/research/lib/sources/arxiv.py, scripts/research/lib/sources/brave.py, scripts/research/lib/sources/crossref.py, scripts/research/lib/sources/devto.py, scripts/research/lib/sources/duckduckgo.py, scripts/research/lib/sources/hackernews.py, scripts/research/lib/sources/keenable.py, scripts/research/lib/sources/lobsters.py, scripts/research/lib/sources/openalex.py, scripts/research/lib/sources/reddit.py, scripts/research/lib/sources/semantic_scholar.py, scripts/research/lib/sources/tavily.py, scripts/research/lib/sources/wikipedia.py, scripts/research/lib/usage.py, scripts/research/lib/vault.py, scripts/research/lib/vault_terms.py, scripts/research/lib/video_frames.py, scripts/research/lib/web_reader.py, scripts/research/lib/youtube.py, scripts/research/notebooklm.py, scripts/research/podcast_extract.py, scripts/research/research.py, scripts/research/research_deep.py, scripts/research/x_pulse.py, scripts/research/x_read.py, scripts/research/youtube_extract.py, scripts/run-command.sh, scripts/session_archive.py, scripts/setup.sh, scripts/setup_settings_hook.py, scripts/stamp_credit.py, scripts/star_prompt.py, scripts/sweep_non_ascii.py, scripts/triage_links.py, scripts/update-vault-integration.sh, scripts/vault_health.py, scripts/vault_plugin_scan.py, scripts/vault_scan.py, scripts/vault_search.py, scripts/vault_stats.py, scripts/verify_quotes.py, update.sh.

Touches

shelldetectednetworkdetectedwrites filesdetectedgitdetectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure25/25
  • Examples15/15
  • Output15/15
  • Size9/15
  • Resources6/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Needs attention
  • File that was not read−15

    a file the skill ships that was not read, so what it does is unknown

    .env.example
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    CITATION.cff
  • Downloads and runs a program−30

    downloads text and runs it as a program

    README.md, line 206
  • Downloads and runs a program−30

    downloads text and runs it as a program

    README.md, line 732
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 74
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 1266
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    adapters/hermes/adapter.sh, line 314
  • Runs git commands−5

    does this on the machine, and the frontmatter does not say so

    adapters/pi/adapter.sh, line 187
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    install.sh, line 112
  • Downloads and runs a program−30

    downloads text and runs it as a program

    install.sh, line 113
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    integrations/telegram-journal/com.user.telegram-journal.plist.example
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    integrations/telegram-journal/telegram_journal.env.example
  • File that was not read−5

    a file the skill ships that was not read, so what it does is unknown

    media/bootstrap-health.tape
  • Downloads and runs a program−30

    downloads text and runs it as a program

    references/crew.md, line 11
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/checkin.py, line 57
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/vault_scan.py, line 139

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community68
  • Maturity28
  • Momentum40

This skill lets an agent read, write and maintain an Obsidian vault of Markdown files. Notes are written for a future agent to read, with a short preamble, rich frontmatter, sources and recency markers. New sources rewrite existing pages, contradictions are reconciled and every write is propagated to the daily note, boards and indexes.

It also bootstraps new vaults from presets, keeps an operation log and ships a research toolkit that pulls X posts, web research, YouTube and podcast transcripts into the vault.

What You Get

  • A bootstrap script and presets for executive, builder, creator and researcher vaults, plus an assistant mode for running a vault for someone else
  • 49 slash commands across operations, thinking tools, context and research
  • Scheduled agents for a morning brief, nightly consolidation, a weekly review and vault health checks
  • An optional MCP server that exposes the vault to other clients such as Claude Desktop and Cursor

Common Use Cases

  • Save the decisions, people and tasks from a meeting into the right notes in one command
  • Ingest a PDF, audio file, image or YouTube link so existing pages are updated
  • Run a vault-first deep research pass that fills only the gaps in what you already know
  • Challenge a decision against your past failures and reversed choices

What Makes It Unique

Where a typical notes skill appends, this one rewrites existing pages, resolves contradictions and writes synthesis pages for patterns across sources. It adds a shared logbook for several coding agents, scheduled maintenance agents and an AI-first note format designed for retrieval by later sessions.

Under The Hood

The agent reads and writes Markdown files across your vault and updates index and log files. It runs Python scripts from the skill folder through the shell, for example to bootstrap a vault, migrate logs or refresh stats, and a setup script can add a session-start hook to your Claude settings file. Research commands call outside services such as Grok, Perplexity, Gemini, the YouTube API and podcast feeds with keys you put in an env file, and ingest can use local Whisper, ffmpeg and LibreOffice. The install script and some of the docs download a script from the internet and run it directly, the installer also uses git, and several adapters touch credentials, so read them before running. Scheduled agents run on their own without you present, and the skill itself tells the agent not to pipe remote install scripts into a shell for you. Read the scripts and hooks before enabling them.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers