From agentic-second-brain
Use when the user asks to load project context from their Obsidian vault, save memory from the current chat, save a session log, capture an inbox note, record a project decision or research note, or any phrase like "load X project", "save memory for X", "save session", "log decision", "save to inbox", "what's in my vault for X". Reads structured project knowledge from a configured vault and writes back per the vault's own CLAUDE.md schema.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agentic-second-brain:agentic-second-brainThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Bridges an AI agent to a user's Obsidian vault. Two operations: `get-knowledge` (load project context) and `save-memory` (write back inbox / session / decision / research notes).
Bridges an AI agent to a user's Obsidian vault. Two operations: get-knowledge (load project context) and save-memory (write back inbox / session / decision / research notes).
AGENTIC_SECOND_BRAIN_VAULT is set and points at a directory → use it.~/.config/agentic-second-brain/config.json. Use the vault_path key.install.sh from the agentic-second-brain repo or set AGENTIC_SECOND_BRAIN_VAULT." Stop.<path> is not a directory." Stop.<vault>/CLAUDE.md.
y, copy templates/vault-CLAUDE.md from the plugin install dir into vault root. On N → refuse to proceed, stop.realpath. Refuse if it does not start with realpath of vault root. No writes outside the vault.get-knowledge <project-or-alias>Two-phase read.
<project-or-alias> using the Project Resolution rules below.<vault>/Projects/<match>/index.md — the menu. Always read.[[...]] from index.md. Build a navigation map (link target → resolved file path candidates) and hold in working context.<vault>/Inbox/<today>.md — today's daily note (YYYY-MM-DD.md in local time). Read if exists.#needs-review referencing this project. Use Grep to find files containing #needs-review, filter to those whose YAML frontmatter project: field equals <match> or whose body wiki-links the project.#action items (same filter as above with #action tag).<vault>/AI/session/ whose filename or body mentions <match>. Sort by filename descending.<vault>/Projects/<match>/decisions/ and <vault>/Projects/<match>/research/.#action items.#needs-review notes.decisions/ and research/ filenames are listed for follow-up.When the user asks about a specific business area in the same conversation:
<vault>/Projects/<match>/**/<link-target>.md (Glob).index.md does not link this topic — they should update the index for next time.Do not re-glob the project on every follow-up. The Phase 1 navigation map is the directory; rely on it.
Use this for every operation that accepts a project argument, including get-knowledge, save-memory decision, save-memory research, and smart saves with a project hint.
<vault>/Projects/* directories.index.md frontmatter only and match exact, case-insensitive aliases from either:
aliases: [short-name, other-name]alias: short-nameDo not use prefix, substring, or fuzzy matching. Aliases are opt-in project metadata, not inferred from folder names.
save-memory [kind] [args]If the user says only save-memory, save memory, save this, or save-memory <project-or-alias> without a kind, run a smart save. The kind words inbox, session, decision, and research are reserved and must be parsed as kinds, not project aliases.
<vault>/AI/session/<YYYY-MM-DD-HH>.md.inbox for raw captures, partial thoughts, or information that should be reviewed before filing.decision only when the conversation contains a clear project decision: context, considered options or tradeoff, and chosen outcome.research when the conversation contains synthesized project knowledge, investigation results, implementation notes, or findings that should become durable project reference material.| Kind | Target file | Behavior |
|---|---|---|
inbox <text> | <vault>/Inbox/<YYYY-MM-DD>.md (today, local time) | Append <text> with a timestamped subheading. Create file from vault CLAUDE.md frontmatter template if missing. |
session | <vault>/AI/session/<YYYY-MM-DD-HH>.md (current local hour, 24-hour) | Write using the "Agent Output Format" structure from vault CLAUDE.md. If file exists for this hour, append a ## Continued section — never overwrite. |
decision <project> <slug> | <vault>/Projects/<project>/decisions/<slug>.md | Write with #decision tag and full frontmatter (title, date, tags, status, project, processed, related). Refuse to overwrite an existing slug — suggest <slug>-2. |
research <project> <slug> | <vault>/Projects/<project>/research/<slug>.md | Create or append synthesized project knowledge using the vault CLAUDE.md schema and a #research tag. If the slug exists, append a timestamped update section; never replace existing content. |
Idempotency rules:
Frontmatter source: read the YAML schema from <vault>/CLAUDE.md "Note Conventions" section. Do not hard-code field names — use what the vault declares.
| Condition | Action |
|---|---|
| Vault path missing / unset | Loud error with fix command. Stop. |
| Vault dir does not exist | Loud error: "Vault path X is not a directory." Stop. |
Vault CLAUDE.md missing | Offer bootstrap. Refuse to proceed if declined. |
/Projects/<name>/ not found | Loud error, list available projects (case-folded). Stop. |
| Project alias matches multiple projects | Loud error, list matching canonical projects. Stop. |
/Projects/<name>/index.md missing | Warn, fall back to Glob-listing project files. Continue. |
| Wiki-link resolves to multiple files | Pick shortest path, warn user. |
| Wiki-link unresolvable | Skip, note in summary. Don't error the whole call. |
| Decision slug exists | Refuse, suggest <slug>-2. |
| Research slug exists | Append timestamped update section. Never overwrite. |
| Session-hour file exists | Append ## Continued section. Never overwrite. |
| Path traversal attempt | Refuse hard, log to user. |
eval).CLAUDE.md across calls — re-reads each invocation.Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub hunine/ai-memory-skills --plugin agentic-second-brain