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/ 位置创建新笔记(除非用户明确指定)

193 stars 28 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add MavCui/Agent-Skills-Hunter --skill obsidian-helper
Manual install
git 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-helper

Personal 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 |
Read the full skill on GitHub

Details

Skill name
obsidian-helper
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

193

MavCui/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.

Frontend & Design28

Webapp Testing

193

MavCui/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.

Testing & QA28

Canvas Design

193

MavCui/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.

Frontend & Design28

Project to Obsidian

193

MavCui/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/) - 禁止自作主张决定输出位置

Productivity & Notes28

Chat Compactor

193

MavCui/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.

Productivity & Notes28

Task Coverage Protocol

117

GoogleCloudPlatform/cxas-scrapi

Enforces 100% task and file ingestion coverage via an asynchronous, supervisor-driven state polling mechanism.

Productivity & Notes117

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.