如何用Agentfiles市场一键安装社区Skills:为任意AI编程工具快速扩展能力
如何用Agentfiles市场一键安装社区Skills:为任意AI编程工具快速扩展能力
Agentfiles 是一款运行在 Obsidian 里的 AI 技能管理器,它的 Marketplace(市场) 功能可以连接 skills.sh 社区仓库,让你一键安装社区技能(Skills) 到 Claude Code、Cursor、Codex、Windsurf 等 17 个 AI 编程工具。无需打开终端、不用手动复制文件,在 Obsidian 中浏览、预览、安装一气呵成。本文带你从零完成一次完整的社区技能安装,5 分钟即可上手。
为什么需要 Agentfiles 市场
使用 Claude Code、Cursor 等 AI 编程工具时,大家往往各自维护一套技能文件:
- Claude Code 的技能在
~/.claude/skills/ - Cursor 的技能在
~/.cursor/skills/ - Codex 的技能在
~/.codex/skills/
手动管理既麻烦又容易遗漏。Agentfiles 把这些分散在各处的文件统一到一个面板里浏览和管理,而它的 Marketplace 标签页更进一步——直接把 skills.sh 上的社区技能搬到你的 Obsidian 里,点一下 Install 就能写入正确的目录,支持一次选多个工具同时安装。
💡 安装社区技能前,你只需要在 Obsidian 中装好 Agentfiles 插件即可,市场功能开箱即用。
第一步:安装 Agentfiles 插件
在 Obsidian 中打开 Settings → Community plugins,搜索 Agentfiles 并启用;也可以打开社区插件页一键安装。
如果习惯手动安装,只需把最新版发布的 main.js、manifest.json、styles.css 三个文件复制到 <vault>/.obsidian/plugins/agentfiles/ 目录,然后在社区插件列表中启用即可(详见 README.md 的 Install 章节)。
第二步:打开 Marketplace 市场面板
启用插件后,打开 Agentfiles 面板,在左侧边栏 Library 区域点击 Marketplace(购物袋图标)即可进入市场面板,入口逻辑见 sidebar.ts。
进入后你会看到:
- 顶部一个搜索框,输入至少 2 个字符即可实时搜索 skills.sh 上的技能(有 300ms 防抖,输入停顿时自动发起搜索);
- 未搜索时默认展示 Popular(热门技能) 列表,按安装量排序;
- 每个技能卡片上显示名称、来源仓库、安装量,已安装的技能会带 Installed 标记。
第三步:预览技能并一键安装
1. 点击技能卡片,预览内容
点击任意技能卡片,右侧会加载该技能的 SKILL.md 原文(以 Markdown 渲染展示)。安装前你可以先确认技能的作用和适用场景——比如 Vercel React 最佳实践这类技能,会明确写出何时触发、包含哪些规则。
2. 点击 Install,选择目标 AI 工具
点击 Install 按钮会弹出安装对话框(逻辑见 install-modal.ts),里面有两项关键设置:
| 选项 | 说明 |
|---|---|
| Install globally | 开启后技能安装到全局目录 ~/.agents/skills/,所有项目共享 |
| Agents 多选 | 勾选技能要写入哪些工具,支持 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf 等 18 个 agent |
几个贴心细节:
- 首次安装时,插件会自动检测你电脑上已安装的 AI 工具(如检测到 Claude Code 会自动勾选),并在名称后显示 "detected" 标记;
- 你上次的选择会被记住(缓存在
~/.skillkit/install-prefs.json),下次安装不用重新勾选; - 至少选择一个 agent 才能安装,否则会提示 "Select at least one agent"。
3. 确认安装,等待完成
点击底部 Install 按钮后,插件会在后台执行安装命令(skills add <source> -a <agents>,参数构建见 marketplace.ts),完成后弹出 "Installed xxx" 通知。此时技能文件已写入对应工具目录,打开 Claude Code 或 Cursor 就能直接使用了。
常见问题与设置
安装失败怎么办?
市场安装底层通过 npx 或 bunx 执行。如果你的网络或运行环境比较特殊,可以在 Settings → Agentfiles → Marketplace → Package runner 中切换执行器(Auto-detect / npx / bunx),该设置逻辑见 settings.ts。
如何卸载或更新技能?
- 卸载:在市场中打开已安装技能的预览页,点击 Uninstall,确认后会从所有 agent 目录中清理副本并清除锁文件记录;
- 批量更新:插件支持
skills update一键更新全部技能,并会提示本次更新了多少个技能。
支持哪些工具?
Agentfiles 市场可安装到的 agent 覆盖 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Amp、OpenCode、Cline、Gemini CLI、Goose、Kilo Code、Roo Code、Continue、OpenHands、Antigravity、Warp、Pi、Replit 等(完整列表见 marketplace.ts 中的 VALID_AGENTS)。不同工具的技能目录对照表可参考 README.md 的 Supported tools 章节。
总结
借助 Agentfiles 市场,给 AI 编程工具添加社区 Skills 的完整流程只有四步:
- 打开 Marketplace 面板;
- 搜索并点击技能卡片预览;
- 勾选目标 AI 工具,选择是否全局安装;
- 点击 Install,等待通知完成。
整个过程不用离开 Obsidian,也完全不用碰命令行——装好 Agentfiles,社区里的高质量技能就能一键为你所用的任意 AI 编程工具赋能。🚀

