Obsidian Skills (kepano)

Name: Obsidian Skills (kepano) (Claude Skill)
Author: kepano

为什么要用

核心特性

真实 Obsidian 用户遵循的 Markdown 惯例
Bases（Obsidian 1.10+）——基于 schema 定义的集合
JSON Canvas——笔记的可视化地图
用于批量操作的 Obsidian CLI 模式
属性/frontmatter 惯用法

实时演示

实际使用效果

就绪

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： Obsidian Skills (kepano)

用一致的属性清理杂乱的 Obsidian vault

👤 长期 Obsidian 用户 ⏱ ~60 min intermediate

何时使用： 多年的笔记积累——标签、属性、文件命名都不一致。

前置条件

Obsidian vault 路径 — 将 skill 指向该路径

步骤

审计

Use obsidian-skills. Audit /vault — list inconsistencies in properties, dead links, orphan notes.✓ 已复制

→ 问题清单
规范化

Migrate tag: to YAML tags: properties consistently.✓ 已复制

→ 受影响笔记的 diff
验证

Re-audit. Confirm orphans have homes and properties are consistent.✓ 已复制

→ 干净的审计结果

结果： 搜索和链接都能干净工作的 vault。

注意事项

批量编辑破坏了插件 — 先在备份副本上测试；skill 会建议这一点

搭配使用： filesystem

将一个文件夹的笔记转换为 Obsidian Base

👤 正在用 Bases 做项目追踪的用户 ⏱ ~45 min intermediate

何时使用： 你想对项目笔记建立一个有类型约束的视图。

步骤

设计 schema

Look at /vault/projects. Propose a Base schema — properties, types, defaults.✓ 已复制

→ schema 规格
迁移

Update each project note to conform. Backfill defaults where missing.✓ 已复制

→ 笔记已符合规格；Base 视图可正常加载

结果： 可工作的 Base；你可以对项目进行排序、过滤和分组。

注意事项

属性类型不匹配 — skill 会验证类型——先修复被标记的笔记，Base 才能干净加载

为某个主题生成相关笔记的 JSON Canvas 地图

👤 研究者 / 写作者 ⏱ ~30 min intermediate

何时使用： 你想直观地看到某个主题下笔记之间的连接关系。

步骤

聚类

Find notes related to 'distributed systems'. Cluster by sub-topic.✓ 已复制

→ 聚类列表
渲染

Render as a JSON Canvas with grouped boxes and edges for backlinks.✓ 已复制

→ .canvas 文件已写入

结果： 可在 Obsidian 中打开并视觉化探索的 canvas。

注意事项

布局节点重叠 — skill 内置基础自动布局；在 Obsidian 中进一步调整

组合

与其他 MCP 搭配，撬动十倍杠杆

obsidian-skills-kepano + filesystem

直接文件访问用于 vault 编辑

Read/write notes via filesystem; obsidian-skills handles conventions.✓ 已复制

obsidian-skills-kepano + claude-obsidian-skill

与 Daniel 的 Claude×Obsidian skill 叠加使用

Use both — kepano for conventions, claude-obsidian for daily workflow.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
audit_vault	path	定期清理时使用	tokens scaled to vault size
design_base	folder	采用 Bases 时使用	tokens
render_canvas	note_set, layout?	生成可视化地图	tokens
obsidian_cli	command	通过 CLI 进行批量操作	tokens for parsing output

成本与限制

运行它的成本

API 配额: N/A
每次调用 Token 数: 大型 vault 消耗较高；按文件夹范围缩小有帮助
费用: 免费
提示: 首次运行时按文件夹审计，而不是整个 vault

安全

权限、密钥、影响范围

最小权限： Read/write to vault

凭据存储： 无

数据出站： 无

个人笔记——使用云端 agent 时注意粘贴到对话中的内容

故障排查

常见错误与修复

Bases schema rejected

所有笔记中的属性类型必须一致——skill 会标记违规笔记

Canvas overlaps

缩小集群规模，或在 Obsidian 中手动调整布局

CLI command not found

单独安装 Obsidian CLI；skill 假设它已在 PATH 中

替代方案