站点图标 高效码农

OpenSkills：让所有 AI 编码代理都能拥有 Claude Code 的技能系统

高效码农

一套真正通用的 AI 技能系统，让你的所有智能编程助手，都能像 Claude Code 一样使用可共享、可扩展的技能。

一、前言：技能系统的价值

在智能编程的时代，我们使用的 AI 工具越来越多：Claude Code、Cursor、Windsurf、Aider……
这些工具的核心在于技能系统（Skills System）——它让 AI 不再只是回答问题，而能执行特定类型的任务。

OpenSkills 正是为了打破工具之间的壁垒而诞生。
它将 Anthropic 的 Claude Code 技能系统 扩展到所有 AI 代码代理，让每个智能体都能使用统一的技能标准。

二、OpenSkills 是什么？

OpenSkills 是一个开源的 CLI 工具，它复刻了 Claude Code 的技能系统，并保持100% 兼容性。
无论你使用哪种 AI 编程助手，都可以通过 OpenSkills：

  • 安装、同步和管理技能；
  • 共享技能文件给不同的智能体；
  • 将技能存储在本地仓库中，统一管理。

它的核心理念是：让技能成为可移植的知识单元，而不是锁定在某个专有平台里。

三、快速开始（HowTo）

下面是最简单的入门方式，只需三步：

npm i -g openskills
openskills install anthropics/skills
openskills sync

执行完这些命令后，你的代理就会自动生成与 Claude Code 完全相同的 <available_skills> 结构。

四、兼容性：与 Claude Code 一致的设计

OpenSkills 不是模仿，而是完全复刻 Claude Code 的结构与行为。

对比项 Claude Code OpenSkills
系统提示来源 内置系统 AGENTS.md 文件
调用方式 Skill("pdf") 工具 openskills read pdf 命令
格式 <available_skills> XML 同格式
文件夹结构 .claude/skills/ .claude/skills/
文件格式 SKILL.md (YAML + Markdown) 相同
渐进加载 支持 支持
资源目录 references/, scripts/, assets/ 相同

唯一的区别是调用方式从 Skill 工具改成了命令行接口。

五、技能的工作原理

1. Claude Code 的技能加载逻辑

当用户输入 “帮我从这个 PDF 里提取数据” 时，Claude 会：

  1. 扫描 <available_skills>；
  2. 匹配到名为 pdf 的技能；
  3. 调用 Skill("pdf")；
  4. 载入 SKILL.md 的内容；
  5. 按照说明执行操作。

2. OpenSkills 的执行方式

OpenSkills 的机制与之完全相同，只是换成了命令行形式：

<skills_system priority="1">
<available_skills>
<skill>
<name>pdf</name>
<description>处理PDF文件的工具集，支持文本提取、表格读取、文件合并与拆分。</description>
<location>project</location>
</skill>
</available_skills>
</skills_system>

六、SKILL.md 文件结构详解

---
name: pdf
description: 提取文本、创建或合并PDF的完整工具包。
---

# 使用说明

1. 安装依赖：`pip install pypdf2`
2. 运行 `scripts/extract_text.py`
3. 使用输出目录中的模板文件

这种结构清晰易读，既适合人类开发者理解，也能被 AI 解析执行。

七、命令行操作指南

openskills install <source> [options]
openskills sync [-y]
openskills list
openskills read <name>
openskills manage
openskills remove <name>

参数说明

  • --global：全局安装；
  • --universal：多代理共用；
  • -y：跳过交互。

八、交互体验

OpenSkills 提供友好的命令行界面（TUI）：

  • 安装界面：可选技能、显示描述；
  • 同步界面：选择同步到 AGENTS.md；
  • 管理界面：批量删除技能。

九、与 MCP 的区别

对比项 MCP Skills（OpenSkills）
类型 协议层 文件层
用途 动态服务连接 静态技能执行
部署 需服务器 无需服务器
通用性 受限 全代理通用

OpenSkills 专注于静态技能加载，不依赖外部通信。

十、通用模式（Universal Mode）

在多代理场景下，可使用：

openskills install anthropics/skills --universal

优点：

  • 多工具共用；
  • 避免冲突；
  • 结构整洁。

十一、创建自己的技能（HowTo）

基础目录

my-skill/
└── SKILL.md

带资源结构

my-skill/
├── SKILL.md
├── scripts/
│   └── process.py
└── assets/
    └── template.json

发布流程

  1. 推送到 GitHub；
  2. 用户执行安装命令：
openskills install your-username/my-skill

十二、示例技能

来自 Anthropic 技能库的典型技能：

  • xlsx：电子表格与公式；
  • docx：文档编辑；
  • pdf：PDF 操作；
  • pptx：演示文稿；
  • canvas-design：视觉设计；
  • mcp-builder：MCP 构建；
  • skill-creator：技能编写指南。

十三、系统要求

  • Node.js 20.6+
  • Git（用于拉取仓库）

十四、常见问题（FAQ）

Q1：OpenSkills 会影响 Claude Code 吗？
不会，二者独立运行。Claude 使用插件系统，OpenSkills 使用 CLI，互不干扰。

Q2：技能能跨项目共享吗？
可以，使用 --global 参数可全局共享。

Q3：如何删除技能？
执行 openskills manage，在界面中选择要移除的技能。

Q4：是否需要联网？
仅安装时需要访问 GitHub，日常使用可离线。

Q5：可以创建自定义技能市场吗？
可以，将技能推送到你的 GitHub 仓库即可。

十五、总结

OpenSkills 让 AI 技能变得开放、标准、通用。
它不仅兼容 Claude Code，还能统一多代理的知识结构，成为开发者在 AI 编程时代的重要基础设施。

许可证：Apache 2.0
说明：本项目实现基于 Anthropic Agent Skills 规范，无官方隶属关系。

✅ 结构化 Schema 数据

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "OpenSkills：让所有 AI 编码代理都能拥有 Claude Code 的技能系统",
  "author": {
    "@type": "Person",
    "name": "OpenSkills Contributors"
  },
  "publisher": {
    "@type": "Organization",
    "name": "OpenSkills Project"
  },
  "about": "OpenSkills 是一个开源 CLI 工具，用于在不同 AI 编码代理之间共享和管理技能系统。",
  "inLanguage": "zh-CN",
  "mainEntityOfPage": "https://github.com/openskills",
  "keywords": ["AI 技能系统", "Claude Code", "OpenSkills", "CLI 工具", "AGENTS.md", "SKILL.md"],
  "hasPart": [
    {
      "@type": "HowTo",
      "name": "如何安装 OpenSkills",
      "step": [
        { "@type": "HowToStep", "text": "执行 npm i -g openskills" },
        { "@type": "HowToStep", "text": "安装 Anthropic 官方技能库 openskills install anthropics/skills" },
        { "@type": "HowToStep", "text": "同步技能至 AGENTS.md 文件 openskills sync" }
      ]
    },
    {
      "@type": "HowTo",
      "name": "如何创建自定义技能",
      "step": [
        { "@type": "HowToStep", "text": "创建 my-skill/ 目录并添加 SKILL.md 文件" },
        { "@type": "HowToStep", "text": "根据功能补充 scripts/ 与 assets/ 文件夹" },
        { "@type": "HowToStep", "text": "上传至 GitHub 并通过 openskills install your-username/my-skill 安装" }
      ]
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "OpenSkills 会影响 Claude Code 吗？",
          "acceptedAnswer": { "@type": "Answer", "text": "不会，OpenSkills 与 Claude Code 互不干扰。" }
        },
        {
          "@type": "Question",
          "name": "技能可以跨项目共享吗？",
          "acceptedAnswer": { "@type": "Answer", "text": "可以，通过 --global 参数实现全局共享。" }
        },
        {
          "@type": "Question",
          "name": "是否需要联网？",
          "acceptedAnswer": { "@type": "Answer", "text": "仅安装阶段需要访问 GitHub，使用阶段可离线运行。" }
        }
      ]
    }
  ]
}
</script>

退出移动版