← Back to Skills Marketplace
theopenbase

Obsidian Read

by theopenbase · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
175
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-read
Description
读取 Obsidian Publish 发布的文档链接。当用户发送 publish.obsidian.md 链接,或需要读取 Obsidian 笔记文章时使用。 适用于从 Obsidian Publish 平台获取完整文章内容、笔记、Essay 等场景。 优先使用 web_fetch,失败时使用 browser...
README (SKILL.md)

Obsidian Read

读取 Obsidian Publish 发布的文档内容。

工作流

步骤 1:优先尝试 web_fetch

web_fetch(url="链接", maxChars=15000)

如果成功返回完整内容,直接使用。

步骤 2:使用 browser 方案(当 web_fetch 失败时)

当 web_fetch 返回内容不完整、404 或解析错误时,使用以下流程:

2.1 打开链接获取 targetId

browser(action="open", url="https://publish.obsidian.md/a/essay/xxx")

返回结果包含 targetId,例如:"579ECBB9218EE0FA843D5CACD2BD99F0"

2.2 读取页面内容

browser(action="snapshot", targetId="上一步获取的targetId")

2.3 提取文本

从 snapshot 结果中提取 paragraphheading 等文本元素,返回给用户。

注意事项

  • 必须用 open 获取 targetId:直接使用 snapshot 而不传 targetId 会导致失败
  • 静态内容优先:Obsidian Publish 是静态站点,snapshot 通常能完整抓取
  • 不需要截图:snapshot 是获取可访问性树(文本内容),不是截图

示例

用户发送:https://publish.obsidian.md/a/essay/202603181132

  1. 先尝试 web_fetch → 失败/不完整
  2. browser.open → 获取 targetId
  3. browser.snapshot → 读取完整文章
  4. 总结文章内容返回给用户
Usage Guidance
This skill appears coherent and minimal: it only fetches public Obsidian Publish pages using web_fetch and a browser snapshot fallback. Before installing, consider: (1) any link you or other users supply will be fetched (so avoid pasting private links you do not want retrieved); (2) the browser tool will load the provided URL and extract text — ensure users understand that content fetched from arbitrary URLs may be presented to the agent. No credentials or installs are required, so there are no hidden requests for secrets.
Capability Analysis
Type: OpenClaw Skill Name: obsidian-read Version: 1.0.0 The obsidian-read skill is designed to extract content from Obsidian Publish links using standard web_fetch and browser tools. The instructions in SKILL.md provide a logical workflow for retrieving document text and do not contain any evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
The name/description (read Obsidian Publish links) matches the runtime instructions which only call web_fetch and a browser tool to open and snapshot publish.obsidian.md pages. No unrelated binaries, env vars, or config paths are requested.
Instruction Scope
SKILL.md is focused and prescriptive: try web_fetch first, then use browser.open to obtain a targetId and browser.snapshot to extract paragraph/heading text. It does not instruct reading local files, other env vars, or exfiltrating data to third parties outside the target site.
Install Mechanism
No install spec or code files are present (instruction-only), so nothing will be written to disk or downloaded. This is the lowest-risk install profile and is appropriate for the described capability.
Credentials
The skill declares no environment variables, secrets, or config paths. That matches its need to fetch public Obsidian Publish pages; no extra credentials are requested.
Persistence & Privilege
always is false and the skill does not request to modify agent config or persist credentials. Autonomous model invocation is allowed (platform default) but that is appropriate for a web-fetching skill.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install obsidian-read
  3. After installation, invoke the skill by name or use /obsidian-read
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - 读取 Obsidian Publish 文档
Metadata
Slug obsidian-read
Version 1.0.0
License MIT-0
All-time Installs 2
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Obsidian Read?

读取 Obsidian Publish 发布的文档链接。当用户发送 publish.obsidian.md 链接,或需要读取 Obsidian 笔记文章时使用。 适用于从 Obsidian Publish 平台获取完整文章内容、笔记、Essay 等场景。 优先使用 web_fetch,失败时使用 browser... It is an AI Agent Skill for Claude Code / OpenClaw, with 175 downloads so far.

How do I install Obsidian Read?

Run "/install obsidian-read" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Obsidian Read free?

Yes, Obsidian Read is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Obsidian Read support?

Obsidian Read is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Obsidian Read?

It is built and maintained by theopenbase (@theopenbase); the current version is v1.0.0.

💬 Comments