Obsidian Helper
Obsidian 智能笔记助手。当用户提到 obsidian、日记、笔记、知识库、capture、review 时激活。 【激活后必须执行】: 1. 先完整阅读本 SKILL.md 文件 2. 理解 AI 写入三条硬规矩(00_Inbox/AI/、追加式、白名单字段) 3. 按 STEP 0 → STEP 1 → ... 顺序执行 4. 不要跳过任何步骤,不要自作主张 【禁止行为】: - 禁止不读 SKILL.md 就开始工作 - 禁止跳过用户确认步骤 - 禁止在非 00_Inbox/AI/ 位置创建新笔记(除非用户明确指定)
Install
npx skills add MavCui/Agent-Skills-Hunter --skill obsidian-helpergit clone --depth 1 https://github.com/MavCui/Agent-Skills-Hunter.git /tmp/Agent-Skills-Hunter
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills-Hunter/obsidian/obsidian-helper ~/.claude/skills/obsidian-helperPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Obsidian Helper - 智能笔记助手
这是一个与 Obsidian MCP 深度整合的智能助手,提供三大核心功能来提升你的笔记效率。
---
## ⚡ 首次使用必读:自动检测与配置引导
### 执行任何功能前,Claude 必须先执行 STEP 0
```
STEP 0: MCP 连接检测(每次会话首次使用时执行)
├─ 尝试调用 obsidian_list_files_in_vault()
├─ 如果成功 → 继续执行用户请求的功能
└─ 如果失败 → 进入【配置引导流程】
```
### 配置引导流程(全中文提示)
当 MCP 连接失败时,Claude 必须向用户显示以下引导信息:
---
**检测到 Obsidian MCP 未连接,我来帮你配置!**
#### 📋 配置步骤
**第一步:安装 Obsidian 插件**
1. 打开 Obsidian → 设置 → 第三方插件
2. 关闭「安全模式」
3. 点击「浏览」,搜索 **Local REST API**
4. 安装并启用该插件
**第二步:获取 API Key**
1. 在 Obsidian 设置中找到 **Local REST API** 插件设置
2. 点击「Copy API Key」复制你的 API Key
3. 记下端口号(默认是 `27124`)
**第三步:配置 Claude Code MCP**
在终端运行以下命令,将 `你的API_KEY` 替换为刚才复制的 Key:
```bash
# 创建 MCP 配置目录(如果不存在)
mkdir -p ~/.claude
# 添加 Obsidian MCP 配置
cat >> ~/.claude/mcp.json << 'EOF'
{
"mcpServers": {
"mcp-obsidian": {
"command": "npx",
"args": ["-y", "mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "你的API_KEY",
"OBSIDIAN_HOST": "https://127.0.0.1:27124"
}
}
}
}
EOF
```
**或者手动编辑** `~/.claude/mcp.json`:
```json
{
"mcpServers": {
"mcp-obsidian": {
"command": "npx",
"args": ["-y", "mcp-obsidian"],
"env": {
"OBSIDIAN_API_KEY": "你的API_KEY",
"OBSIDIAN_HOST": "https://127.0.0.1:27124"
}
}
}
}
```
**第四步:重启 Claude Code**
```bash
# 完全退出 Claude Code,然后重新启动
claude
```
**第五步:验证连接**
重启后,再次输入你想要的命令(如 `/daily`),我会自动验证连接是否成功。
---
#### ❓ 常见问题
| 问题 | 解决方案 |
|------|----------|
| 插件找不到 | 确保 Obsidian 版本 ≥ 1.0.0 |Details
- Skill name
obsidian-helper- Repository
- MavCui/Agent-Skills-Hunter
- Path
obsidian/obsidian-helper/SKILL.md- License
- MIT
- Repo updated
- 10 March 2026
FAQ
What does the Obsidian Helper skill do?
Obsidian 智能笔记助手。当用户提到 obsidian、日记、笔记、知识库、capture、review 时激活。 【激活后必须执行】: 1. 先完整阅读本 SKILL.md 文件 2. 理解 AI 写入三条硬规矩(00_Inbox/AI/、追加式、白名单字段) 3. 按 STEP 0 → STEP 1 → ... 顺序执行 4. 不要跳过任何步骤,不要自作主张 【禁止行为】: - 禁止不读 SKILL.md 就开始工作 - 禁止跳过用户确认步骤 - 禁止在非 00_Inbox/AI/ 位置创建新笔记(除非用户明确指定)
How do I install the Obsidian Helper skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add MavCui/Agent-Skills-Hunter --skill obsidian-helper. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Obsidian Helper popular?
It lives in MavCui/Agent-Skills-Hunter, which has 193 GitHub stars and 28 forks.
Related skills
Brand Guidelines
193MavCui/Agent-Skills-Hunter
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Webapp Testing
193MavCui/Agent-Skills-Hunter
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
Canvas Design
193MavCui/Agent-Skills-Hunter
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Project to Obsidian
193MavCui/Agent-Skills-Hunter
将代码项目转换为 Obsidian 知识库。当用户提到 obsidian、项目文档、知识库、分析项目、转换项目 时激活。 【激活后必须执行】: 1. 先完整阅读本 SKILL.md 文件 2. 理解 AI 写入规则(默认到 00_Inbox/AI/、追加式、统一 Schema) 3. 执行 STEP 0: 使用 AskUserQuestion 询问用户确认 4. 用户确认后才开始 STEP 1 项目扫描 5. 严格按 STEP 0 → 1 → 2 → 3 → 4 顺序执行 【禁止行为】: - 禁止不读 SKILL.md 就开始分析项目 - 禁止跳过 STEP 0 用户确认 - 禁止直接在 30_Resources 创建(先到 00_Inbox/AI/) - 禁止自作主张决定输出位置
Chat Compactor
193MavCui/Agent-Skills-Hunter
Generate structured session summaries optimized for future AI agent consumption. Use when (1) ending a coding/debugging session, (2) user says "compact", "summarize session", "save context", or "wrap up", (3) context window is getting long and continuity matters, (4) before switching tasks or taking a break. Produces machine-readable handoff documents that let the next session start fluently without re-explaining.
Task Coverage Protocol
117GoogleCloudPlatform/cxas-scrapi
Enforces 100% task and file ingestion coverage via an asynchronous, supervisor-driven state polling mechanism.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.