OpenSkills技能安装和使用指南

一、OpenSkills 的基本认识

OpenSkills 是一个开源的 AI 技能管理与运行时框架，核心是让 AI Agent 能像调用软件组件一样，透明、可组合、可复用地执行各类技能（Skill），并兼容 Anthropic Claude Skills 生态。

跨工具兼容：让 Cursor、Trae、Qoder 等非 Claude 工具也能使用 Claude 官方技能库。

1、最流行的跨工具技能安装器

https://github.com/numman-ali/openskills

2、透明化 Agent 技能框架（Python）

https://github.com/twwch/openskills

3、金融 / 交易场景技能运行时

https://github.com/Geeksfino/openskills

4、AI Agent 技能注册中心（MCP 生态）

https://github.com/OpenSkillsHub

二、OpenSkills 的AI 技能的全套操作

安装 → 同步 → 查看 → 使用 → 更新 → 删除

# 安装技能npx openskills install <source> [options]# 同步技能清单npx openskills sync [-y] [-o <path>]# 查看已安装的技能npx openskills list# 读取某个技能的内容npx openskills read <name># 更新技能npx openskills update [name...]# 管理 / 删除技能（交互式）npx openskills manage# 删除指定技能npx openskills remove <name>

--global— 全局安装~/.claude/skills（默认：项目安装）
--universal— 安装到.agent/skills/而不是.claude/skills/
-y, --yes— 跳过提示（对持续集成很有用）
-o, --output <path>— 同步输出文件（默认值AGENTS.md：）

三、OpenSkills的两种安装区别

2.1、把技能安装到.agent/skills/

npx openskills install anthropics/skills --universalnpx openskills sync

2.2、把技能安装到./.claude/skills

npx openskills install anthropics/skills --globalnpx openskills sync

默认情况下，安装是项目本地的（./.claude/skills，或./.agent/skills使用--universal）。--global用于~/.claude/skills。

如果您将 Claude Code和其他带有该插件的代理一起使用AGENTS.md，请安装该插件以.agent/skills/避免与 Claude 的插件市场发生冲突：

优先级顺序：

./.agent/skills/
~/.agent/skills/
./.claude/skills/
~/.claude/skills/

四、OpenSkills 开始安装skills技能

4.1、现在~/.claude/目录下还没有技能

4.2、执行安装技能仓库的时候报错

网络问题，开启代理，进行配置

配置 Git 代理

# 配置 SOCKS5  代理（替换成你的代理地址和端口）git config --global http.proxy socks5://127.0.0.1:7890git config --global https.proxy socks5://127.0.0.1:7890# 重新执行安装命令npx openskills install anthropics/skills --global

底部操作提示：

↑↓ navigate：上下箭头移动光标，选择 / 取消单个技能

space select：按空格键，选中 / 取消当前高亮的技能

a all：按 a 键，全选 / 取消全选所有技能

i invert：按 i 键，反选所有技能

↵ submit：按回车键（Enter），确认选择，开始安装

4.3、选择全部技能并安装

#查看已安装的技能npx openskills list

同步技能清单：

把你安装的技能，「告诉」AI 工具，让 AI 能找到并使用这些技能。

生成 AGENTS.md 文件，列出所有已安装技能，能，AI 读取这个文件就知道有哪些技能。

npx openskills sync

4.3、技能清单说明

技能英文名	中文名称	核心功能
`algorithmic-art`	算法艺术生成	用代码生成几何艺术、算法图案、交互式可视化
`brand-guidelines`	品牌规范设计	生成 LOGO、配色方案、字体规范、完整品牌手册
`canvas-design`	画布设计工具	基于 HTML Canvas 绘制海报、图表、界面原型
`doc-coauthoring`	文档协作助手	多人文档协作、自动排版、结构化内容生成
`docx`	Word 文档处理	读写 docx/doc、提取文本 / 表格、修改格式、批量处理
`frontend-design`	前端界面设计	自动生成 HTML/CSS/JS、响应式界面、UI 组件
`internal-comms`	内部通讯模板	生成企业通知、公告、邮件、会议纪要模板
`mcp-builder`	MCP 工具构建器	开发 AI 插件、MCP 服务、自定义工具
`pdf`	PDF 处理工具	创建 / 合并 / 拆分 PDF、提取文本 / 图片、格式转换
`pptx`	PPT 自动生成	自动生成幻灯片、排版美化、插入图表 / 图片
`skill-creator`	技能创建器	辅助编写 SKILL.md、开发自定义技能
`slack-gif-creator`	GIF 表情包制作	生成动图、表情包、短视频片段
`theme-factory`	主题生成工厂	生成 VS Code/IDE/ 软件主题、配色方案
`web-artifacts-builder`	Web 产物构建器	打包前端项目、生成静态资源、自动化部署
`webapp-testing`	Web 应用测试	自动生成测试用例、功能测试、Bug 检测
`xlsx`	Excel 表格处理	读写 Excel、生成报表、数据处理、批量操作
`template`	通用模板生成器	生成各类文件骨架、项目模板、代码模板

4.4、到工作目录，启动 Claude Code

Claude Code 常用命令速查（建议收藏）

claude

查看安装的技能

4.5、本地项目安装（不依赖全局，适合单项目）

# 进入项目目录（比如 D:\VibeCoding\workspaces\PyDocToPDF）cd D:\VibeCoding\workspaces\PyDocToPDF# 本地安装，不加--globalnpx openskills install anthropics/skills# 同步生成AGENTS.mdnpx openskills sync

项目来源：Qoder 快速上手指南

五、在项目里面用webapp-testing技能输出测试用例

这里只演示一个技能

帮我用 webapp-testing 技能，测试我当前项目里的 Word 转 PDF 桌面应用（main.py）,最后用 docx 技能把测试报告整理成 Word 文档

正在创建测试报告中....

查看使用技能给我生成的测试报告：

六、创建自己的私有技能

最小结构

my-skill/└── SKILL.md

安装您自己的技能：

npx openskills install ./my-skill

把你自己的私有技能仓库，克隆到本地开发目录：

git clone git@github.com:your-org/my-skills.git ~/dev/my-skillsmkdir -p .claude/skillsln -s ~/dev/my-skills/my-skill .claude/skills/my-skill

创建自己的私有技能：

npx openskills install anthropics/skillsnpx openskills read skill-creator

最小结构

更多资源结构

安装您自己的技能：