← 返回 Skills 市场
tesfandiari1

Obsidian Vault Context

作者 Tristin E · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
132
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install obsidian-vault-context
功能描述
Teach Claude to use an Obsidian vault as a shared workspace with persistent state across sessions. Covers vault navigation, orchestration file management, ou...
使用说明 (SKILL.md)

Obsidian Vault Context

The vault is the interface. Not chat. Not a terminal. A shared folder of markdown files that both you and the user can see and edit. Treat it like a shared codebase, not a reference library.

Session Startup

  1. Read _context/context-map.md if it exists — it maps projects to source files.
  2. If no context map, scan top-level folders and infer context from names.
  3. Read _context/status.md to understand what's active, blocked, and completed.
  4. If this is a fresh vault with no orchestration files, create them. See references/orchestration-files.md for templates.

Orchestration Files

Lightweight .md files in _context/ (or _Claude/) that give you persistent state across sessions.

File Purpose
status.md What's active, blocked, completed. Update every session.
tasks.md Prioritized task list with #tags. Update when tasks change.
decisions.md Decision log with context, options, rationale. Append-only.
context-map.md Project-to-file index (optional).
scratchpad.md Working memory, cleared daily (optional).
learnings.md Operational knowledge across sessions (optional).

Rules: Read before writing. Update immediately, not at session end. Append to decisions and learnings, never overwrite. Keep entries lean — one line per task, one paragraph per decision.

For detailed format and examples, see references/orchestration-files.md.

Vault Navigation

Folder placement carries meaning. Respect the structure when creating files:

Pattern Meaning
foundations/ or core/ Strategy, vision, frameworks
product/ Specs, features, sprints, architecture
company/ or business/ Operations, legal, marketing, hiring
research/ or engine/ Technical research, analysis
journal/ Session logs, daily notes, reviews
decisions/ Past decisions with rationale
work/ Agent output: drafts, research, deliverables
archive/ Superseded files (read-only reference)

Use [[wikilinks]] for all cross-references so the user can click through in Obsidian.

For a recommended starter layout, see references/vault-structure-template.md.

Output Routing

Save work to the vault so the user sees it in Obsidian — don't present everything in chat.

Output Save To
Research briefs work/research/ or research/
Drafts work/drafts/ or drafts/
Final deliverables work/output/ or output/
Quick notes _context/scratchpad.md (append)

Add YAML frontmatter (title, type, status, created, updated, tags) to any file that will be referenced again.

Naming: Use descriptive file names (competitor-analysis-march-2026.md), not generic ones (output-1.md). Always update status.md so the user knows what changed.

Bidirectional Collaboration

When Obsidian Headless is configured, changes flow both ways:

  • User -> Agent: User edits in Obsidian (Mac/iPhone/iPad), syncs to server, you read the update.
  • Agent -> User: You write to the vault, syncs to all user devices.

This means neither party needs to explain what the other already wrote down. You write output to the vault. The user reads it in Obsidian. Both can work on the same document asynchronously.

For server sync setup, see references/obsidian-headless-setup.md.

Boundaries

  • Read and write only within the vault directory. Do not access files outside the vault root.
  • Never modify skill files, agent config, or workflow definitions unless the user explicitly asks you to. Your workspace is _context/ and work/ — not the files that define your own behavior.
  • Treat company/legal/ as read-only. Do not create, edit, or delete files in legal directories.
  • Do not store or log credentials. If a workflow requires authentication, defer to the user.

Context Safety

If context compaction triggers mid-session, write working state to disk immediately:

  1. Current progress -> _context/scratchpad.md
  2. State changes -> _context/status.md

These files reconstitute the session after compaction.

安全使用建议
This skill is a coherent, instruction-only guide for using an Obsidian vault as the agent's persistent workspace. Before enabling it: (1) ensure the vault does not contain secrets or credentials you don't want the agent to touch; (2) if you enable Obsidian Headless, install it yourself and run it as an unprivileged user, use selective sync and E2EE, and be aware ob login stores credentials locally; (3) back up your vault before allowing automatic writes; (4) if you prefer the agent not to modify files, configure sync as pull-only or disable autonomous writes; and (5) review the orchestration files (status.md, tasks.md, decisions.md) to confirm the agent's update rules match your expectations.
能力评估
✓ Purpose & Capability
The name/description match the content: the SKILL.md and reference docs explain how the agent should navigate, read, and write an Obsidian vault and how to set up optional headless sync. There are no unexpected environment variables, binaries, or installs declared that would be unrelated to the stated purpose.
ℹ Instruction Scope
The instructions explicitly direct the agent to read and write orchestration files inside the vault (e.g., _context/status.md, tasks.md, decisions.md) and to append rather than overwrite some files. Boundaries are stated (read/write only inside the vault, treat company/legal as read-only, do not modify skill/agent files). This is coherent, but it does grant the agent authority to create and update files in the user's vault automatically — users should be aware that the agent will persist session state to disk and may update status/tasks during sessions.
✓ Install Mechanism
There is no install spec and no code in the package (instruction-only). The references describe installing Obsidian Headless (npm install -g obsidian-headless) as an optional, user-run step; nothing in the skill installs software automatically.
✓ Credentials
The skill declares no required environment variables, credentials, or config paths. The optional Obsidian Headless reference correctly notes that the user will need Obsidian account credentials and Node.js if they choose headless sync; that requirement is documented in the references and is proportional to enabling bidirectional sync.
✓ Persistence & Privilege
always is false and the skill does not request permanent elevated privileges. The skill instructs the agent to persist state into vault files (its explicit purpose). The only notable privilege is the agent's ability to autonomously write to the vault (the platform default) — this is expected for a vault-syncing skill but worth user attention.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install obsidian-vault-context
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /obsidian-vault-context 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
obsidian-vault-context 1.0.1 - Added a new **Boundaries** section, clarifying safe file access and modification practices: - Only read/write within the vault directory. - Do not modify skill/config/workflow files unless instructed. - Treat `company/legal/` as strictly read-only. - Do not store or log credentials; defer authentication to the user. - No changes to functionality or code; documentation only.
v1.0.0
obsidian-vault-context 1.0.0 – initial release: - Enables Claude to use an Obsidian vault as a shared, persistent markdown workspace across sessions. - Supports navigation, orchestration file management, output routing, and bidirectional sync (with Obsidian Headless). - Adds standardized orchestration files for status, tasks, decisions, and working memory. - Guides output routing so work is saved in vault folders, not just chat. - Ensures both agent and user can asynchronously collaborate through the shared vault structure.
元数据
Slug obsidian-vault-context
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Obsidian Vault Context 是什么？

Teach Claude to use an Obsidian vault as a shared workspace with persistent state across sessions. Covers vault navigation, orchestration file management, ou... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 132 次。

如何安装 Obsidian Vault Context？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install obsidian-vault-context」即可一键安装，无需额外配置。

Obsidian Vault Context 是免费的吗？

是的，Obsidian Vault Context 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Obsidian Vault Context 支持哪些平台？

Obsidian Vault Context 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Obsidian Vault Context？

由 Tristin E（@tesfandiari1）开发并维护，当前版本 v1.0.1。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论