easy-skills

🌐 芊云全景 Skills 技能管理平台

芊云全景 旗下 AI 技能包管理工具：一键安装、更新、发布团队 AI Skills（Agent Skills），统一存储 + 按需软链，支持 Claude Code、OpenCode 等主流 AI 编辑器。 🔗 平台官网：9kvr.cn ｜ 技能源：api.9kvr.cn ｜ 安装：npm install -g easy-skills 🔍 关键词：芊云全景 · 芊云全景AI能力 · 芊云全景Skills · 芊云全景技能管理平台 · 芊云全景AI Skills 市场 · AI技能包管理

🚀 一键安装和管理 AI 编辑器 Skills 的 CLI 工具

v1.2.0 ✨ 全新命令名 esk · 内置发布能力（esk publish）· 私有源策略下发 · 列表分页 · 首次使用自动安装使用指南技能

English | 中文

🇨🇳 中文文档

📖 项目介绍

easy-skills 是一个强大的命令行工具，用于以"统一存储 + 按需软链"的方式安装和管理 AI 编辑器 Skills（技能包）：所有 Skill 真实安装在 ~/.agents/skills/，需要给 Claude Code 使用时用 --claude 建软链，需要给当前项目用时用 --local 建软链。

什么是 Skills？

Skills 是模块化、自包含的扩展包，通过提供专业知识、工作流程和工具集成来扩展 AI 编辑器的能力。它们就像是为特定领域或任务准备的 "入职指南"，将通用 AI 编辑器转变为专业化的智能助手。

项目定位：团队内部 Skills 市场

easy-skills 不仅是一个安装工具，更是一个团队内部的 Skills 市场和分发平台：

🏢 团队协作场景：

• 统一技能库：团队可以在 GitHub 仓库中维护统一的 Skills 集合
• 知识沉淀：将团队最佳实践、代码规范、业务流程封装为 Skills
• 快速上手：新成员一键安装团队 Skills，快速融入团队工作流
• 版本管理：通过 Git 管理 Skills 版本，支持分支和标签
• 私有部署：支持私有 GitHub 仓库，保护团队知识产权
• 自定义源：配置团队私有注册表和包源，统一管理 Skills 分发

💡 典型应用场景：

• 代码规范：团队统一的代码评审标准和风格指南
• 业务流程：特定业务领域的工作流程和最佳实践
• 工具集成：团队常用工具的集成和使用指南
• 文档模板：项目文档、技术方案、专利申请等标准模板
• 领域知识：特定技术栈或业务领域的专业知识库

🔄 工作流程：

方式1 (GitHub): 团队维护 Skills → 推送到 GitHub → 成员通过 GitHub URL 安装
方式2 (私有源): 团队维护 Skills → 发布到私有源 → 配置源地址 → 成员从源安装

为什么需要 easy-skills？

• 🎯 统一管理：一个工具管理所有 AI 编辑器的 Skills
• 🚀 快速安装：一条命令即可安装 Skills，自动从 CDN 或 GitHub 拉取
• 📦 灵活来源：支持内置注册表、GitHub 仓库、本地文件、远程 URL
• 🔄 团队共享：通过 GitHub 或私有源轻松分享和同步团队 Skills
• ⚙️ 可配置源：类似 npm，支持自定义注册表源和包源
• 💡 交互式界面：友好的命令行交互，新手也能轻松上手
• 🎨 统一存储架构：真实内容只在 ~/.agents/skills/ 一处，其他位置全是软链

✨ 核心特性

🌐 平台支持（v2.0 起收敛为 2 个）

| 平台 | 安装方式 | 说明 | |------|---------|------| | ✅ Agent（默认） | 真实安装 | 统一存储 ~/.agents/skills/<skill>/，不带任何参数即安装到这里 | | ✅ Claude Code | 软链 | --claude 时创建 ~/.claude/skills/<skill> → 统一存储 |

📦 内置 Skills

• patent-writer: AI专利撰写专家工具
  • ✅ 本地文件评审 + 远程MR评审
  • ✅ 多维度分析（质量、安全、性能）
  • ✅ 支持多种编程语言
• patent-writer: AI专利撰写专家
  • ✅ 辅助撰写符合 CNIPA 规范的专利文本
• skill-creator: Skills 官方指南
  • ✅ 教你如何创建高质量 Skills 的官方教程
  • ✅ 包含初始化脚本和最佳实践
• project-proposal-expert: 项目计划书专家
  • ✅ 编写技术研发项目计划书
  • ✅ 从原始资料提取核心逻辑
  • ✅ 生成逻辑严谨、量化支撑的正式文档
• project-completion-report-expert: 项目结题报告专家
  • ✅ 编写技术研发项目结题报告
  • ✅ 研发成果与立项承诺闭环对比
  • ✅ 分析技术先进性与指标达成情况

🔌 多种安装方式

# 交互式安装（最简单，推荐使用）
easy-skills install

# 按名称从注册表安装
easy-skills install patent-writer

# 从团队 GitHub 仓库安装（自动识别）
easy-skills install https://github.com/your-team/skills-repo
easy-skills install github:your-team/skills-repo
easy-skills install your-team/skills-repo

# 从 GitHub 仓库的特定目录安装
easy-skills install https://github.com/your-team/skills-repo/tree/main/skills/my-skill
easy-skills install github:your-team/skills-repo/skills/my-skill

# 安装到当前项目（本地模式，软链到 ./.claude/skills/）
easy-skills install patent-writer --local

# 额外给 Claude Code 使用（软链 ~/.claude/skills/<skill> → 统一存储）
easy-skills install patent-writer --claude

# 从本地文件安装
easy-skills install ./my-skill.skill

🏢 团队协作特性

• GitHub 集成：直接从团队 GitHub 仓库安装 Skills
• 私有源支持：配置团队私有注册表和包源（类似 npm）
• 版本控制：支持指定分支、标签或 commit
• 私有仓库：支持私有 GitHub 仓库（需配置访问权限）
• 子目录支持：可以从仓库的特定目录安装单个 Skill
• 批量管理：一个仓库可以包含多个 Skills，按需安装

🚀 快速开始

安装

全局安装（推荐）

npm install -g easy-skills

或使用 npx（无需安装）

npx easy-skills <command>

第一次使用

1. 查看可用的 Skills

esk list
# 或简写
es ls

2. 一键安装 Skill (推荐)

   全新的交互式安装体验，支持按分类浏览：

esk install
# 将进入交互菜单：
# ? 浏览 Skills [Root]: (Use arrow keys)
# ❯ 📁 💻 研发效能 
#   📁 📝 文档写作 

3. 从团队仓库安装

# 安装团队维护的 Skill
esk install your-team/skills-repo/skills/team-standard

# 或使用完整 URL
esk install https://github.com/your-team/skills-repo/tree/main/skills/team-standard

完成！现在您可以在AI编辑器中使用新安装的Skill了。

🏢 团队使用场景

场景 1：切换到团队私有源

# 添加团队源（packageBaseUrl 会自动推导为 https://skills.your-team.com/packages/）
esk reg add team https://skills.your-team.com/registry.json

# 切换到团队源
esk reg use team

# 安装 Skill（自动从团队源获取）
esk install onboarding-skills

场景 2：项目特定 Skills

# 在项目目录下安装项目专用 Skills
cd my-project
esk install your-team/project-skills --scope local

场景 3：更新团队规范

# 强制更新到最新版本
esk install your-team/code-standards --force

� 使用指南

🌐 多源管理 (Registry)

easy-skills 支持配置多个 Skill 源，方便在官方源、团队私有源和本地测试源之间切换。

# 列出所有源
esk reg ls
# 输出示例：
# * default ---- https://cdn.jsdelivr.net/gh/tianming3/easy-skills-package@main/skills-registry.json
#   custom ----- https://skills.example.com/registry.json

# 添加新源（名称、注册表URL、[可选]包下载基础URL）
esk reg add my-team https://skills.example.com/registry.json

# 如果包不在默认的 packages/ 目录，可以指定完整路径
esk reg add my-team \
  https://skills.example.com/registry.json \
  https://cdn.example.com/skills/

# 切换当前使用的源
esk reg use my-team

# 删除源（不能删除 default 源）
esk reg del my-team

packageBaseUrl 自动推导规则：

• 如果不指定 packageBaseUrl，会自动从 registryUrl 推导
• 例如：https://skills.example.com/skills-registry.json → https://skills.example.com/packages/
• 推导规则：取 registryUrl 的目录部分 + /packages/

配置文件位置：

• macOS/Linux: ~/.easy-skills/config.json
• Windows: %USERPROFILE%\.easy-skills\config.json

默认配置： 默认为 default 源，从 GitHub CDN (jsdelivr) 获取最新 Skills。

注意： 旧版本的 esk config --set 命令已废弃，请使用 esk reg add 管理源，令牌通过 esk reg token <源名> <Key> 配置。

列出 Skills

列出 Skills

# 列出所有可用的 Skills 和已安装的 Skills
easy-skills list
# 或使用简写
easy-skills ls

安装 Skill

按名称安装（默认，无交互）

# 真实安装到 ~/.agents/skills/patent-writer/
easy-skills install patent-writer

# 额外软链给 Claude Code：~/.claude/skills/patent-writer → 统一存储
easy-skills install patent-writer --claude
# 等价写法
easy-skills install patent-writer --platform claude

从 GitHub 安装（自动识别）

# 完整 URL
easy-skills install https://github.com/user/repo

# 简写形式
easy-skills install github:user/repo
easy-skills install gh:user/repo
easy-skills install user/repo

# 从仓库的特定目录安装
easy-skills install https://github.com/user/repo/tree/main/skills/my-skill
easy-skills install github:user/repo/skills/my-skill

# 指定分支
easy-skills install https://github.com/user/repo/tree/develop

从本地文件安装

easy-skills install --file ./my-skill.skill
# 或直接指定文件
easy-skills install ./my-skill.skill

从远程URL安装

easy-skills install --url https://example.com/skills/my-skill.skill

指定目标平台

# 默认（推荐）：真实安装到 ~/.agents/skills/
easy-skills install patent-writer

# 额外给 Claude Code 使用：软链 ~/.claude/skills/<skill> → 统一存储
easy-skills install patent-writer --claude

指定安装范围（全局/本地）

# 全局安装（默认）：真实安装到 ~/.agents/skills/<skill>/
easy-skills install patent-writer

# 本地安装：软链到当前项目 ./.claude/skills/<skill>
easy-skills install patent-writer --local

# 两者都要
easy-skills install patent-writer --claude --local

强制覆盖已存在的 Skill

easy-skills install patent-writer --force

卸载 Skill

交互式卸载

easy-skills uninstall

按名称卸载

easy-skills uninstall patent-writer

指定平台

# 默认：卸载统一存储中的真实内容（claude 软链自动失效需另行清理或 --claude 只清软链）
easy-skills uninstall patent-writer

# 只卸载 ~/.claude/skills/ 软链（统一存储保留）
easy-skills uninstall patent-writer --claude

更新 Skill

智能更新（推荐）

easy-skills update
# 自动检测版本，只更新有新版本的 Skills

强制更新

easy-skills update --force
# 强制重新安装，跳过版本检查

按名称更新

easy-skills update patent-writer

指定平台更新

# claude 软链指向统一存储，更新真实目录后自动生效，无需单独操作
easy-skills update patent-writer

检查过期的 Skills

# 查看哪些 Skills 有新版本
easy-skills outdated

# JSON 输出（用于脚本）
easy-skills outdated --json

🛠️ 开发 Skills

创建新的 Skill

交互式创建（推荐） 🎯

easy-skills create
# 会提示您选择模板、输入作者等信息
# 默认创建在 ./packages/ 目录下

快速创建 ⚡

# 基础模板（仅 SKILL.md）
easy-skills create my-skill --template basic --author "Your Name" --description "My skill description"

# 高级模板（包含完整目录结构）
easy-skills create my-skill --template advanced --author "Your Name" --description "My skill description"

# MCP 模板（用于 MCP 集成）
easy-skills create my-skill --template mcp --author "Your Name" --description "My skill description"

# 指定创建目录
easy-skills create my-skill --dir ./custom-dir

默认目录结构：

your-project/
└── packages/              # 默认创建目录
    ├── my-skill/
    │   └── SKILL.md
    └── another-skill/
        ├── SKILL.md
        ├── scripts/
        └── references/

模板类型：

• 🎯 basic: 基础模板，只包含 SKILL.md
• 🚀 advanced: 高级模板，包含 scripts/、references/、assets/ 目录
• 🔌 mcp: MCP 模板，专门用于 MCP 服务器集成

验证 Skill

# 基础验证 ✅
easy-skills validate my-skill

# 严格模式（检查可选字段和内容完整性）🔍
easy-skills validate my-skill --strict

# 自动修复常见问题 🔧
easy-skills validate my-skill --fix

# JSON 输出 📊
easy-skills validate my-skill --json

验证内容：

• ✅ SKILL.md 文件存在
• ✅ YAML frontmatter 格式正确
• ✅ 必需字段：name、description、version
• ✅ 版本号符合 semver 规范
• ✅ name 格式正确（小写字母、数字、连字符）
• ⚠️ 推荐字段：author、license、tags
• ⚠️ 描述长度合理（10-200 字符）

打包 Skill

# 基础打包（自动验证）📦
easy-skills pack my-skill

# 指定输出路径 📂
easy-skills pack my-skill -o ./dist/my-skill.skill

# 跳过验证（不推荐）⚠️
easy-skills pack my-skill --no-validate

# 显示详细信息 📋
easy-skills pack my-skill --verbose

打包特性：

• ✅ 自动验证 Skill 结构
• ✅ 自动排除不需要的文件（.git、node_modules 等）
• ✅ 生成 SHA256 校验和
• ✅ 显示文件数量和大小

完整开发流程

# 1. 创建 Skill 🎨（默认在 packages/ 目录）
easy-skills create my-awesome-skill --template advanced

# 2. 编辑 SKILL.md 和其他文件 ✏️
cd packages/my-awesome-skill
# ... 编辑文件 ...

# 3. 验证 🔍
easy-skills validate packages/my-awesome-skill --strict

# 4. 修复问题（如果有）🔧
easy-skills validate packages/my-awesome-skill --fix

# 5. 打包 📦
easy-skills pack packages/my-awesome-skill

# 6. 测试安装 🧪
easy-skills install my-awesome-skill.skill

# 7. 发布到 GitHub 或私有源 🚀
# ...

升级现有 Skill

如果你有旧版本的 Skills 缺少 version、hash、author 等字段，可以使用 upgrade 命令自动添加：

升级单个 Skill 🔄

# 预览模式（不修改文件）
easy-skills upgrade ./my-skill --dry-run

# 实际升级
easy-skills upgrade ./my-skill --author "Your Name"

批量升级 📦

# 升级目录下所有 skills
easy-skills upgrade ./packages --recursive --author "Your Name"

# 交互式选择要升级的 skills
easy-skills upgrade ./packages --recursive --interactive

升级选项：

• --recursive, -r: 递归处理目录下所有 skills
• --interactive, -i: 交互式选择要升级的 skills
• --dry-run: 预览模式，不实际修改文件
• --force: 强制覆盖所有字段（包括已存在的）
• --author <name>: 指定默认作者
• --license <type>: 指定默认许可证（默认: MIT）
• --add-missing-only: 只添加缺失字段，不修改已有字段

升级内容：

• ✅ 自动添加 version: 1.0.0（如果缺失）
• ✅ 自动添加 author（如果缺失）
• ✅ 自动添加 license: MIT（如果缺失）
• ✅ 自动计算并添加 hash（6位内容哈希）
• ✅ 按标准顺序重新排列字段
• ✅ 升级前自动备份，验证失败自动恢复

示例输出：

$ es upgrade ./packages --recursive --author "tianming3"

🔍 扫描目录...
找到 10 个 skills

正在升级 10 个 skills...

[1/10] patent-writer... ✓
[2/10] code-review... ✓
...

==================================================
升级报告
==================================================

总计: 10 个 skills
  ✓ 成功: 10 个
  ⊘ 跳过: 0 个
  ✗ 失败: 0 个

成功升级:
  ✓ patent-writer: +version, +author, +license, +hash
  ✓ code-review: +version, +author, +license, +hash
  ...

🎯 支持的平台详情

✨ 为什么推荐 Agent 平台？

Agent 是各大 AI 编辑器厂商正在推进的行业标准目录：

• 🌐 统一标准: 使用统一的 ~/.agent/skills/ 路径
• 🔄 跨平台共享: 一次安装，多个编辑器共享使用
• 🚀 未来趋势: 所有主流 AI 编辑器都将支持此目录
• 💡 简化管理: 不需要为每个编辑器单独安装 Skills

使用示例：

# 安装到 Agent 平台（推荐）
esk install patent-writer --platform agent

# 安装后，所有支持 .agent 目录的编辑器都可以使用
# 包括：Antigravity、未来的其他编辑器等

📋 平台列表

| 平台 | Skills路径 | 自动检测 | Skills支持 | |------|-----------|---------|-----------| | ✨ Agent (推荐) | ~/.agent/skills/ | ✅ | ✅ 行业标准（各大厂商推荐） | | Antigravity | ~/.agent/skills/ | ✅ | ✅ 官方支持 | | Gemini CLI | ~/.gemini/skills/ | ✅ | ✅ 官方支持 | | Claude Code | ~/.claude/skills/ | ✅ | ✅ 官方支持 | | Windsurf | ~/.windsurf/skills/ | ✅ | ✅ 官方支持 (Agent Skills for Cascade, 2026-01-11) | | Trae AI | ~/.trae/skills/ | ✅ | ✅ 官方支持 (AI Agents + MCP + Skills) | | Cursor | ~/.cursor/skills/ (全局) .cursor/skills/ (项目) | ✅ | ✅ 官方支持 (支持项目级和用户级) | | Kiro | ~/.kiro/skills/ | ✅ | ✅ 官方支持 (Agent Hooks + Steering + Skills) | | Cline | ~/.cline/skills/ | ✅ | 🔧 实验性 | | JoyCode | ~/.joycode/skills/ | ✅ | 🚧 未来/自定义 (支持 MCP & 多智能体) |

图例说明：

• ✅ 官方支持: 平台官方支持 Skills 系统
• 🔧 实验性: Skills 目录结构可用，可能需要手动设置
• 🚧 未来/自定义: 为未来支持或自定义扩展预留

📦 内置 Skills 详情

patent-writer - AI专利撰写专家工具

一个功能强大的代码质量评审工具，支持本地文件和远程MR评审。

主要功能：

• ✅ 多维度分析: 代码质量、性能、安全性全方位评审
• ✅ 本地文件评审: 快速评审本地代码文件
• ✅ 远程MR评审: 支持GitLab MR的完整评审流程
• ✅ 智能文件筛选: 自动过滤无关文件
• ✅ 行内评论: 直接在代码行发布评论
• ✅ 多语言支持: JavaScript/TypeScript、Python、Java、Go等

安装方式：

easy-skills install patent-writer

patent-writer - AI专利撰写专家

帮助用户将技术创意或交底书转化为符合中国国家知识产权局(CNIPA)规范的专利申请文本。

主要功能：

• ✅ 符合CNIPA规范: 按照中国专利局标准撰写
• ✅ 技术交底书转换: 将技术文档转化为专利文本
• ✅ 专业术语优化: 使用专利领域专业表达

安装方式：

easy-skills install patent-writer

skill-creator - Skills 官方指南

教你如何创建高质量 Skills 的官方教程，包含完整的开发工具链。

主要功能：

• ✅ 官方最佳实践: Skills 开发标准和规范
• ✅ 初始化脚本: 快速创建 Skill 项目结构
• ✅ 打包工具: 一键打包为 .skill 文件
• ✅ 示例模板: 丰富的 Skill 开发示例

安装方式：

easy-skills install skill-creator

project-proposal-expert - 项目计划书专家

专门用于编写技术研发项目计划书的专家，擅长从原始资料中提取核心逻辑并按专业标准生成正式文档。

主要功能：

• ✅ 专业结构: 符合技术研发项目标准格式
• ✅ 逻辑提取: 从原始资料中提炼核心内容
• ✅ 量化支撑: 提供数据化的项目指标和论证
• ✅ 正式文档: 生成规范的项目计划书

安装方式：

easy-skills install project-proposal-expert

project-completion-report-expert - 项目结题报告专家

专门用于编写技术研发项目结题报告的专家，擅长将研发成果与立项承诺进行闭环对比。

主要功能：

• ✅ 闭环对比: 研发成果与立项目标的对比分析
• ✅ 技术先进性: 分析技术创新点和先进性
• ✅ 指标达成: 评估项目指标完成情况
• ✅ 成果总结: 系统化梳理项目成果

安装方式：

easy-skills install project-completion-report-expert

🛠️ 创建自己的 Skill

提示: 现在可以使用 easy-skills create 命令快速创建 Skill！

方式 1: 使用 create 命令（推荐）

# 交互式创建
easy-skills create my-skill

# 或快速创建
easy-skills create my-skill --template advanced --author "Your Name" --description "My skill"

这会自动创建标准的目录结构和模板文件。

方式 2: 手动创建

步骤 1: 创建 Skill 目录结构

my-skill/
├── SKILL.md           # 必需：Skill 描述文件
├── scripts/           # 可选：辅助脚本
├── references/        # 可选：参考文档
└── assets/           # 可选：资源文件

步骤 2: 编写 SKILL.md

---
name: my-skill
description: 我的自定义 Skill 描述
---

# My Skill

这里是 Skill 的详细说明...

## 功能

- 功能1
- 功能2

## 使用方法

...

步骤 3: 打包为 .skill 文件

使用 pack 命令（推荐）

easy-skills pack my-skill

或手动打包

.skill 文件其实就是 ZIP 压缩包：

# 在 my-skill 目录的父目录执行
zip -r my-skill.skill my-skill/

步骤 4: 安装你的 Skill

easy-skills install --file my-skill.skill

完成！你的自定义 Skill 已安装成功。

🏢 团队 Skills 管理最佳实践

方式 1: 使用 GitHub 仓库（推荐快速开始）

优点：

• 无需额外基础设施
• 利用 Git 的版本控制能力
• 支持私有仓库保护知识产权
• 团队成员直接通过 URL 安装

推荐的团队仓库结构

your-team-skills/
├── README.md                          # 仓库说明
├── skills/                            # Skills 目录
│   ├── code-standards/                # 代码规范 Skill
│   │   ├── SKILL.md
│   │   └── references/
│   ├── onboarding/                    # 新人入职 Skill
│   │   ├── SKILL.md
│   │   └── guides/
│   ├── project-template/              # 项目模板 Skill
│   │   └── SKILL.md
│   └── business-workflow/             # 业务流程 Skill
│       └── SKILL.md
└── .github/
    └── workflows/                     # CI/CD 自动化
        └── validate-skills.yml

团队工作流程

1. 创建团队 Skills 仓库

# 在 GitHub 创建仓库
gh repo create your-team/skills --private

# 克隆到本地
git clone https://github.com/your-team/skills.git
cd skills

2. 添加新的 Skill

# 创建 Skill 目录
mkdir -p skills/my-new-skill
cd skills/my-new-skill

# 编写 SKILL.md
vim SKILL.md

# 提交到仓库
git add .
git commit -m "Add my-new-skill"
git push

3. 团队成员安装

# 安装特定 Skill
easy-skills install your-team/skills/skills/my-new-skill

# 或安装整个仓库（如果仓库根目录有 SKILL.md）
easy-skills install your-team/skills

4. 版本管理

# 安装特定分支
easy-skills install https://github.com/your-team/skills/tree/develop/skills/my-skill

# 安装特定标签（通过 GitHub Release）
easy-skills install https://github.com/your-team/skills/tree/v1.0.0/skills/my-skill

方式 2: 使用私有源（推荐企业级部署）

优点：

• 集中管理和分发
• 更好的访问控制
• 支持内网部署
• 类似 npm 的使用体验
• 可以与 CI/CD 集成

搭建私有源

1. 创建注册表文件 (skills-registry.json)

{
  "version": "1.0.0",
  "skills": [
    {
      "name": "team-skills",
      "displayName": "🏢 团队技能",
      "type": "category",
      "children": [
        {
          "name": "team-standards",
          "displayName": "团队代码规范",
          "description": "团队统一的代码规范和最佳实践",
          "version": "1.0.0",
          "tags": ["standards", "code-review"],
          "type": "skill",
          "path": "team-standards.skill"
        }
      ]
    },
    {
        "name": "onboarding",
        "displayName": "新人入职指南",
        "description": "帮助新成员快速了解团队和项目",
        "version": "1.0.0",
        "tags": ["onboarding", "guide"],
        "type": "skill",
        "path": "onboarding.skill"
    }
  ]
}

注册表字段说明：

| 字段 | 类型 | 必填 | 说明 | 示例 | |------|------|------|------|------| | 顶层字段 | | version | string | ✅ | 注册表版本号 | "1.0.0" | | skills | array | ✅ | Skills 列表（支持树形结构） | [...] | | Category 节点字段（分类） | | name | string | ✅ | 分类唯一标识（英文） | "team-skills" | | displayName | string | ✅ | 分类显示名称（可含 emoji） | "🏢 团队技能" | | type | string | ✅ | 节点类型，固定为 "category" | "category" | | children | array | ✅ | 子节点列表（可包含分类或 Skill） | [...] | | welcomeMessage | string | ❌ | 进入该分类时显示的欢迎语 | "欢迎使用团队工具集" | | Skill 节点字段（技能包） | | name | string | ✅ | Skill 唯一标识（英文，用于安装） | "team-standards" | | displayName | string | ✅ | Skill 显示名称 | "团队代码规范" | | description | string | ✅ | Skill 功能描述 | "团队统一的代码规范..." | | version | string | ✅ | Skill 版本号 | "1.0.0" | | type | string | ✅ | 节点类型，固定为 "skill" | "skill" | | path | string | ✅ | Skill 包文件路径（相对或绝对） | "team-standards.skill" | | tags | array | ❌ | 标签列表（用于搜索和分类） | ["standards", "review"] |

path 字段说明：

• 相对路径："team-standards.skill" → 自动拼接为 {packageBaseUrl}/team-standards.skill
• 子目录路径："team/standards.skill" → 拼接为 {packageBaseUrl}/team/standards.skill
• 完整 URL："https://cdn.example.com/skills/my-skill.skill" → 直接使用该 URL

注意事项：

• type 字段必须明确指定为 "category" 或 "skill"，用于区分分类节点和技能节点。

2. 部署到服务器

# 目录结构
/var/www/skills/
├── skills-registry.json       # 注册表文件
└── packages/                  # Skills 包目录
    ├── team-standards.skill
    ├── onboarding.skill
    └── ...

3. 配置 Web 服务器 (Nginx 示例)

server {
    listen 80;
    server_name skills.your-company.com;
    
    root /var/www/skills;
    
    location / {
        add_header Access-Control-Allow-Origin *;
        try_files $uri $uri/ =404;
    }
}

4. 团队成员配置

# 添加团队私有源（packageBaseUrl 自动推导）
easy-skills reg add company https://skills.your-company.com/skills-registry.json

# 切换到团队源
easy-skills reg use company

# 查看所有源
easy-skills reg ls

# 安装 Skills（自动从私有源获取）
easy-skills install team-standards
easy-skills install onboarding

5. 更新 Skills

# 在服务器上更新 .skill 文件和 skills-registry.json
# 团队成员执行更新
easy-skills update team-standards

方式对比

| 特性 | GitHub 仓库 | 私有源 | |------|------------|--------| | 部署难度 | ⭐ 简单 | ⭐⭐⭐ 需要服务器 | | 版本控制 | ✅ Git 原生支持 | ⚠️ 需要手动管理 | | 访问控制 | ✅ GitHub 权限 | ✅ 服务器权限 | | 内网部署 | ❌ 需要 GitHub Enterprise | ✅ 完全支持 | | 使用体验 | 需要完整 URL | 类似 npm，简洁 | | 适用场景 | 中小团队、快速开始 | 大型企业、严格管控 |

推荐方案

• 小团队/初创公司: 使用 GitHub 私有仓库，简单快速
• 中型团队: GitHub + 私有源混合，公共 Skills 用 GitHub，敏感 Skills 用私有源
• 大型企业: 完全私有源部署，集成到内部基础设施

团队 Skills 示例

代码规范 Skill (code-standards)

• 团队编码规范
• ESLint/Prettier 配置
• Git commit 规范
• Code Review 检查清单

新人入职 Skill (onboarding)

• 开发环境搭建指南
• 团队工具使用说明
• 常用命令和脚本
• 团队联系方式

项目模板 Skill (project-template)

• 项目初始化模板
• 目录结构规范
• 配置文件模板
• README 模板

业务流程 Skill (business-workflow)

• 需求评审流程
• 开发测试流程
• 发布上线流程
• 应急响应流程

🏗️ 开发者指南

Build

npm install
npm run build

Local Testing

# Build the project
npm run build

# Link locally
npm link

# Test commands
easy-skills list
easy-skills install patent-writer

Project Structure

easy-skills/
├── src/
│   ├── cli.ts                    # CLI entry point
│   ├── index.ts                  # Main exports
│   ├── types/
│   │   └── index.ts              # Type definitions
│   ├── platforms/
│   │   └── index.ts              # Platform configurations
│   ├── utils/
│   │   ├── file.ts               # File operations
│   │   ├── downloader.ts         # Download utilities
│   │   ├── executor.ts           # Command execution
│   │   ├── registry.ts           # Skills registry loader
│   │   └── installer.ts          # Skill installer
│   └── commands/
│       ├── list.ts               # List command
│       ├── install.ts            # Install command
│       └── uninstall.ts          # Uninstall command
├── bundled-skills/               # Built-in .skill files
│   └── patent-writer.skill
├── skills-registry.json          # Skills metadata
├── package.json
├── tsconfig.json
└── README.md

💡 常见问题（FAQ）

A: 使用 reg add 命令添加自定义源：

# 添加团队源（packageBaseUrl 会自动推导）
easy-skills reg add team https://your-company.com/registry.json

# 如果包不在默认的 packages/ 目录，可以手动指定
easy-skills reg add team \
  https://your-company.com/registry.json \
  https://cdn.your-company.com/skills/

# 切换到团队源
easy-skills reg use team

# 查看所有源
easy-skills reg ls

自动推导规则：

• https://your-company.com/registry.json → https://your-company.com/packages/
• https://your-company.com/path/to/registry.json → https://your-company.com/path/to/packages/

配置后，所有 install 和 update 操作都会从当前激活的源获取 Skills。

注意： 旧版本的 config --set 命令已废弃。

A:

1. 在 GitHub 创建私有仓库
2. 按照推荐结构组织 Skills
3. 团队成员配置 GitHub 访问权限
4. 使用 easy-skills install your-team/private-repo/skills/skill-name 安装

对于私有仓库，确保已配置 GitHub 认证（SSH 密钥或 Personal Access Token）。

A: 工具会自动识别 GitHub URL，支持多种格式：

• 完整 URL: easy-skills install https://github.com/user/repo
• 简写形式: easy-skills install github:user/repo 或 easy-skills install user/repo
• 子目录: easy-skills install https://github.com/user/repo/tree/main/skills/my-skill
• 指定分支: easy-skills install https://github.com/user/repo/tree/develop

工具会自动下载、验证并安装 Skill。

A: .skill 文件本质上就是一个 ZIP 压缩包，包含了 Skill 的所有文件。您可以使用任何 ZIP 工具来创建或解压它。

A: 使用 easy-skills uninstall <skill-name> 命令即可卸载。

A: 目前支持 9 个 AI 编辑器：Antigravity、Gemini CLI、Claude Code、Windsurf、Trae AI、Cursor、Kiro、Cline 和 JoyCode。其中前 7 个平台已官方支持 Skills 系统。

A: 确保您的 AI 编辑器已正确安装，并且主目录存在（如 ~/.agent/、~/.gemini/、~/.claude/ 等）。

🤝 贡献指南

欢迎贡献！如果您想为项目做贡献：

1. Fork 这个仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

🔗 相关链接

• npm 包
• GitHub 仓库
• 问题反馈

🙏 致谢

感谢所有为这个项目做出贡献的开发者！

🇺🇸 English Documentation

📖 Introduction

easy-skills is a powerful CLI tool for installing and managing Skills across multiple AI editor platforms.

What are Skills?

Skills are modular, self-contained extension packages that enhance AI editors with specialized knowledge, workflows, and tool integrations.

Positioning: Internal Team Skills Marketplace

easy-skills serves as an internal Skills marketplace and distribution platform for teams:

Team Collaboration:

• Unified Skills Repository: Maintain team Skills in GitHub repositories
• Knowledge Base: Encapsulate best practices, code standards, and workflows
• Quick Onboarding: New members install team Skills with one command
• Version Control: Manage Skills versions through Git branches and tags
• Private Deployment: Support private GitHub repositories for IP protection

Typical Use Cases:

• Code standards and review guidelines
• Business workflows and best practices
• Tool integrations and usage guides
• Document templates (technical specs, patents, etc.)
• Domain-specific knowledge bases

🚀 Quick Start

Install globally

npm install -g easy-skills

Or use with npx

npx easy-skills <command>

List available skills

easy-skills list

Install a skill

# From registry
easy-skills install patent-writer

# From GitHub (auto-detect)
easy-skills install https://github.com/user/repo
easy-skills install github:user/repo
easy-skills install user/repo

# From GitHub subdirectory
easy-skills install https://github.com/user/repo/tree/main/skills/my-skill

# From local file
easy-skills install ./my-skill.skill

📖 Commands

Basic Commands:

• esk list - Browse available & installed skills (paginated, --page/--page-size/--search/--json)
• esk install - Interactive installation (Recommended)
• esk install [skill] - Install a specific skill
• esk uninstall - Interactive uninstallation
• esk update - Update skills (smart version comparison)
• esk outdated - Check for outdated skills

Development Commands:

• esk create <name> - Create a new skill from template
• esk validate <path> - Validate skill structure
• esk pack <path> - Package skill as .skill file

Publishing:

• esk publish <path> - Publish to current source (requires api.publish + token)
• esk published - List skills published to current source (paginated)

Configuration:

• esk reg ls - List all registries
• esk reg use <name> - Switch registry
• esk reg add <name> <url> - Add custom registry
• esk reg token <name> <key> - Set management token for a registry
• esk config - Configure settings (legacy)
• esk --help - Show help information

🎯 Supported Platforms

9 AI editors supported: Antigravity, Gemini CLI, Claude Code, Windsurf, Trae AI, Cursor, Kiro (official Skills support with Agent Hooks and Steering), Cline, and JoyCode.

📦 Built-in Skills

• patent-writer: AI patent writing tool with local and remote MR review capabilities
• patent-writer: AI patent writing expert for CNIPA-compliant patent applications
• skill-creator: Official guide for creating high-quality Skills with tools and best practices
• project-proposal-expert: Expert for writing technical R&D project proposals
• project-completion-report-expert: Expert for writing technical R&D project completion reports

🛠️ Creating Custom Skills

1. Create a directory with SKILL.md
2. Package as .skill file: zip -r my-skill.skill my-skill/
3. Install: easy-skills install --file my-skill.skill

📄 License

MIT License

Star ⭐ this repo if you find it useful!