kepano/obsidian-skills
⭐ 30,150 · None · GitHub 仓库
用于Obsidian的智能体技能。教授您的智能体使用Markdown、Bases、JSON Canvas以及命令行界面。
claude clawdbot cli codex defuddle obsidian openclaw opencode
一句话总结
教会AI编程代理原生管理Obsidian知识库，通过标准化技能集处理Markdown、Bases和CLI操作。
🔥 核心能力与独特卖点
- Obsidian风格Markdown技能：代理可创建和编辑
.md文件，支持维基链接、嵌入、标注和属性。解决手动格式化复杂Obsidian笔记的痛点，无需编写自定义提示词教代理掌握Obsidian专属语法。 - Obsidian Bases技能：代理可创建和编辑包含视图、筛选器、公式和摘要的
.base文件。解决在Obsidian中以编程方式管理结构化数据和类数据库视图的挑战。 - JSON Canvas技能：代理可创建和编辑包含节点、边和分组的
.canvas文件。解决以编程方式生成或修改可视化知识图谱和思维导图的难题。 - Obsidian CLI技能：提供插件/主题开发及通过CLI与知识库交互的代理能力。解决自动化开发工作流和知识库操作时的摩擦，无需人工干预。
- Defuddle技能：从网页提取干净Markdown，去除冗余内容以节省Token。解决代理为知识库研究抓取网络内容时的高Token消耗和噪声问题。
独特卖点：遵循平台无关的Agent Skills规范，开箱即用兼容Claude Code、Codex CLI和OpenCode——无供应商锁定。
技术架构
| 组件 | 描述 |
|---|---|
| 技能格式 | skills/文件夹下的独立技能目录，每个目录包含遵循Agent Skills规范的SKILL.md文件 |
| 代理平台 | 兼容Claude Code、Codex CLI、OpenCode（及任何支持该规范的平台） |
| 安装方式 | 市场插件、npx CLI或手动git克隆 |
| 无语言依赖 | 语言无关；技能定义为Markdown指令而非代码 |
| 可扩展性 | 模块化设计允许添加新技能而不影响现有技能 |
快速入门指南
通过Obsidian插件市场安装：
bash
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills或通过npx安装（适用于Claude Code、Codex CLI）：
bash
npx skills add git@github.com:kepano/obsidian-skills.git
npx skills add https://github.com/kepano/obsidian-skillsOpenCode手动安装：
bash
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills优势、局限与使用场景
优势
- 平台无关：兼容多种代理系统（Claude Code、Codex CLI、OpenCode）
- 开放规范：遵循社区标准，确保未来兼容性
- 全面覆盖：涵盖最重要的Obsidian专属格式（Markdown、Bases、Canvas、CLI）
- 零代码开销：技能基于Markdown指令，非复杂代码库
- 活跃生态：30,150星标彰显强大的社区认可度
局限
- 需代理环境：不能独立使用，需配合Claude Code、Codex CLI或OpenCode
- 平台特定设置：不同代理平台安装步骤各异，增加初始使用门槛
- 无图形界面：完全命令行和代理驱动，无可视化管理界面
- 学习曲线：用户需同时理解Obsidian和所选代理系统
不适用人群
- 非Obsidian用户：不使用Obsidian则本项目毫无价值
- 偏好GUI的用户：若偏爱可视化工具而非CLI/代理驱动工作流，请绕道
- 单一平台用户：若只使用一个代理系统且无切换计划，更简单的平台专属方案可能足够
- Token敏感新手：代理生态系统需理解CLI工具和AI交互模式
理想使用场景
- 自动化知识库管理：批量创建、编辑和组织带有Obsidian专属格式的笔记
- 知识库内容摄入：使用Defuddle抓取网页内容，自动生成结构清晰的Obsidian笔记
- 插件/主题开发：利用CLI技能自动化Obsidian插件构建、测试和部署
- 可视化画布生成：通过JSON Canvas以编程方式创建复杂思维导图和关系图
- 团队知识工作流：标准化AI代理与共享Obsidian知识库的交互方式，支持多人协作
社区与活跃度
凭借30,150星标和持续更新（最近更新于2026年5月10日），该项目显然在Obsidian+AI社区引起了强烈共鸣。高星标数反映了Obsidian重度用户和AI代理爱好者群体的广泛采用与认可。项目维护活跃，已成为将AI代理与Obsidian工作流集成的事实标准。鉴于代理工具的迅猛发展，该项目有望成为Obsidian-AI交互的权威技能集。