obsidian-skills
obsidian-skills 是一套专为 Obsidian 设计的智能体技能包，旨在让 AI 助手（如 Claude Code、Codex CLI 等）真正“读懂”并操作你的笔记库。它解决了通用 AI 模型难以精准处理 Obsidian 特有格式（如双向链接、画布文件、Bases 数据库）的痛点，避免生成不符合规范的文本或破坏文件结构。
这套工具非常适合依赖 Obsidian 进行知识管理的开发者、研究人员及重度笔记用户。通过安装 obsidian-skills，你可以指挥 AI 自动创建和编辑符合 Obsidian 语法的 Markdown 文档、构建复杂的 Bases 视图、绘制 JSON Canvas 思维导图，甚至调用命令行接口管理插件与主题。此外，它还集成了 Defuddle 功能，能自动清理网页抓取内容中的杂乱信息，帮助节省 AI 上下文 token。
其核心亮点在于严格遵循通用的 Agent Skills 规范，实现了跨平台兼容，无需复杂配置即可在多种主流 AI 开发环境中即插即用。无论是想自动化整理文献的研究者，还是希望提升工作流效率的技术人员，obsidian-skills 都能让你的 AI 助手从单纯的“聊天伙伴”进化为得力的“笔记管家”。
使用场景
一位知识管理博主正试图让 AI 助手自动整理每周收集的碎片化资讯，并将其转化为结构化的 Obsidian 知识库。
没有 obsidian-skills 时
- AI 生成的 Markdown 文件缺乏 Obsidian 特有的语法（如双向链接
[[ ]]、属性块或引用块），导致笔记无法在库中自动关联。 - 面对网页长文，AI 直接复制粘贴大量无关的导航栏和广告代码，不仅浪费 Token，还让笔记内容杂乱无章。
- 无法直接创建或编辑 JSON Canvas 画布文件，用户必须手动在界面中拖拽节点来构建思维导图，效率极低。
- 想要批量安装插件或调整主题时，AI 因不懂 Obsidian CLI 命令，只能提供模糊的文字指导，无法直接执行操作。
- 每次都需要人工二次校对和重写格式，原本期望的“自动化工作流”实际上变成了"AI 起草 + 人工重做”。
使用 obsidian-skills 后
- AI 调用
obsidian-markdown技能，直接输出包含正确维基链接、Callout 警告块和 Frontmatter 属性的标准笔记，即存即用。 - 通过
defuddle技能，AI 在写入前先清洗网页内容，仅提取纯净正文，显著节省 Token 并提升阅读体验。 - 利用
json-canvas技能，AI 能根据文本逻辑自动生成.canvas文件，一键将线性笔记转化为可视化的概念关系图。 - 借助
obsidian-cli技能，AI 可直接运行命令安装所需插件或切换主题，无需用户离开终端手动操作。 - 整个流程实现端到端自动化：从网页抓取、清洗、格式化到生成可视化看板，用户只需最后确认即可。
obsidian-skills 赋予了 AI 真正理解并操作 Obsidian 原生格式的能力，将繁琐的格式调整工作转变为流畅的知识构建体验。
运行环境要求
- Linux
- macOS
- Windows
未说明
未说明
快速开始
适用于 Obsidian 的代理技能。
这些技能遵循 Agent Skills 规范，因此任何兼容技能的代理都可以使用它们，包括 Claude Code 和 Codex CLI。
安装
市场
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
npx skills
npx skills add git@github.com:kepano/obsidian-skills.git
手动安装
Claude Code
将此仓库的内容添加到您的 Obsidian 库根目录下的 /.claude 文件夹中（或您正在与 Claude Code 一起使用的任何文件夹）。更多信息请参阅 官方 Claude Skills 文档。
Codex CLI
将 skills/ 目录复制到您的 Codex 技能路径中（通常为 ~/.codex/skills）。有关标准技能格式，请参阅 Agent Skills 规范。
OpenCode
将整个仓库克隆到 OpenCode 的技能目录中（~/.opencode/skills/）：
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills
请勿仅复制内部的 skills/ 文件夹——必须克隆整个仓库，以确保目录结构为 ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md。
OpenCode 会自动发现 ~/.opencode/skills/ 下的所有 SKILL.md 文件。无需更改 opencode.json 或任何配置文件。重启 OpenCode 后，技能即可使用。
技能
| 技能 | 描述 |
|---|---|
| obsidian-markdown | 创建和编辑带有维基链接、嵌入、提示框、属性及其他 Obsidian 特定语法的 Obsidian 风格 Markdown（.md）文件 |
| obsidian-bases | 创建和编辑带有视图、过滤器、公式和摘要的 Obsidian Bases（.base）文件 |
| json-canvas | 创建和编辑带有节点、边、组和连接的 JSON Canvas 文件（.canvas） |
| obsidian-cli | 通过 Obsidian CLI 与 Obsidian 库进行交互，包括插件和主题开发 |
| defuddle | 使用 Defuddle 从网页中提取干净的 Markdown，去除杂乱内容以节省 token 数量 |
相似工具推荐
ML-For-Beginners
ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。 无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。
OpenHands
OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。 无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。 其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。
gpt4free
gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。 无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。 其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。
gstack
gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。 这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `/review` 进行代码审查、`/qa` 执行测试、`/plan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。 所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。
meilisearch
Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。 Meilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。
awesome-claude-skills
awesome-claude-skills 是一个精心整理的开源资源库，旨在帮助用户挖掘和扩展 Claude AI 的潜力。它不仅仅是一份列表，更提供了实用的“技能（Skills）”模块，让 Claude 从单纯的文本生成助手，进化为能执行复杂工作流的智能代理。 许多用户在使用 AI 时，常受限于其无法直接操作外部软件或处理特定格式文件的痛点。awesome-claude-skills 通过预设的工作流解决了这一问题：它不仅能教会 Claude 专业地处理 Word、PDF 等文档，进行代码开发与数据分析，还能借助 Composio 插件连接 Slack、邮箱及数百种常用应用，实现发送邮件、创建任务等自动化操作。这使得重复性任务变得标准化且可复用，极大提升了工作效率。 无论是希望优化日常办公流程的普通用户、需要处理复杂文档的研究人员，还是寻求将 AI 深度集成到开发管线中的开发者，都能从中找到适合的解决方案。其独特的技术亮点在于“技能”的可定制性与强大的应用连接能力，让用户无需编写复杂代码，即可通过简单的配置让 Claude 具备跨平台执行真实任务的能力。如果你希望让 Claude