easy-skills weekly downloads statistics

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 分发

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

🔄 工作流程：

为什么需要 easy-skills？

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

✨ 核心特性

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

| 平台 | 安装方式 | 说明 |

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

📦 内置 Skills

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

🔌 多种安装方式

🏢 团队协作特性

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

🚀 快速开始

安装

全局安装（推荐）

或使用 npx（无需安装）

第一次使用

1. 查看可用的 Skills

2. 一键安装 Skill (推荐) 全新的交互式安装体验，支持按分类浏览：

3. 从团队仓库安装

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

🏢 团队使用场景

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

场景 2：项目特定 Skills

场景 3：更新团队规范

� 使用指南

🌐 多源管理 (Registry)

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

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 配置。

列出 Skills

列出 Skills

安装 Skill

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

从 GitHub 安装（自动识别）

从本地文件安装

从远程URL安装

指定目标平台

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

强制覆盖已存在的 Skill

卸载 Skill

交互式卸载

按名称卸载

指定平台

更新 Skill

智能更新（推荐）

强制更新

按名称更新

指定平台更新

检查过期的 Skills

🛠️ 开发 Skills

创建新的 Skill

交互式创建（推荐） 🎯

快速创建 ⚡

默认目录结构：

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

验证 Skill

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

打包 Skill

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

完整开发流程

升级现有 Skill

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

升级单个 Skill 🔄

批量升级 📦

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

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

示例输出：

🎯 支持的平台详情

✨ 为什么推荐 Agent 平台？

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

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

使用示例：

📋 平台列表

| 平台 | 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等

安装方式：

patent-writer - AI专利撰写专家

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

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

安装方式：

skill-creator - Skills 官方指南

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

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

安装方式：

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

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

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

安装方式：

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

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

Description from the npm listing.