AI Skills Package Manager - Git-based skills management for AI agents
npm install reskill![]()
基于 Git 的 AI Agent Skills 包管理器
类似 npm/Go modules 的声明式 skill 管理 — 安装、版本控制、同步和共享 AI agent skills


English | 简体中文
---
``bash`
npx reskill@latest init
npx reskill@latest install github:anthropics/skills/frontend-design@latest
npx reskill@latest list
- 一键安装 — 从任意 Git 仓库一键安装 skill
- 声明式配置 — skills.json + skills.lock 确保团队一致性
- 灵活版本 — 精确版本、semver 范围、分支、commit
- 多源支持 — GitHub、GitLab、自建仓库、HTTP/OSS 归档
- 多 Agent — Cursor、Claude Code、Codex、Windsurf、GitHub Copilot 等
- Registry 支持 — 发布和共享 skills
环境要求: Node.js >= 18.0.0
`bash`
npm install -g reskill # 全局安装
npx reskill@latest
| 命令 | 别名 | 说明 |
| ---- | ---- | ---- |
| init | - | 初始化 skills.json |install [skills...]
| | i | 安装一个或多个 skills |list
| | ls | 列出已安装的 skills |info
| | - | 查看 skill 详情 |update [skill]
| | up | 更新 skills |outdated
| | - | 检查过期的 skills |uninstall
| | un, rm, remove | 卸载 skill |publish [path]
| | pub | 发布 skill 到 registry ¹ |login
| | - | 登录 registry ¹ |logout
| | - | 登出 registry ¹ |whoami
| | - | 显示当前登录用户 ¹ |doctor
| | - | 诊断环境并检查问题 |
> ¹ Registry 相关命令(publish、login、logout、whoami)需要部署私有 registry 后才能使用,暂不对外开放。completion install
| | - | 安装 Shell Tab 补全 |
| 选项 | 适用命令 | 说明 |
| ---- | ------- | ---- |
| --no-save | install | 安装时不保存到 skills.json(用于个人技能) |-g, --global
| | install, uninstall, list | 全局安装/管理技能(用户目录) |-a, --agent
| | install | 指定目标 Agent(如 cursor, claude-code) |--mode
| | install | 安装模式:symlink(默认)或 copy |--all
| | install | 安装到所有 Agent |-y, --yes
| | install, uninstall, publish | 跳过确认提示 |-f, --force
| | install | 强制重新安装 |-j, --json
| | list, info, outdated, doctor | JSON 格式输出 |
运行 reskill 查看完整选项和详细用法。
`bashGitHub 简写
npx reskill@latest install github:user/skill@v1.0.0
$3
对于包含多个技能的仓库(monorepo),可以指定技能目录的路径:
`bash
简写格式带子路径
npx reskill@latest install github:org/monorepo/skills/planning@v1.0.0
npx reskill@latest install gitlab:company/skills/frontend/components@latestURL 格式带子路径
npx reskill@latest install https://github.com/org/monorepo.git/skills/planning@v1.0.0
npx reskill@latest install git@gitlab.company.com:team/skills.git/backend/apis@v2.0.0GitHub 网页 URL 自动提取子路径
npx reskill@latest install https://github.com/org/monorepo/tree/main/skills/planning
`要求:指定的目录必须包含符合 Agent Skills 规范 的有效
SKILL.md 文件。$3
支持从 HTTP/HTTPS URL 直接安装归档文件:
| 格式 | 示例 | 说明 |
| ---- | ---- | ---- |
| HTTPS URL |
https://example.com/skill.tar.gz | 直接下载链接 |
| 阿里云 OSS | https://bucket.oss-cn-hangzhou.aliyuncs.com/skill.tar.gz | 阿里云 OSS URL |
| AWS S3 | https://bucket.s3.amazonaws.com/skill.tar.gz | AWS S3 URL |
| OSS 协议 | oss://bucket/path/skill.tar.gz | 阿里云 OSS 简写 |
| S3 协议 | s3://bucket/path/skill.tar.gz | AWS S3 简写 |支持的归档格式:
.tar.gz、.tgz、.zip、.tar版本规范
| 格式 | 示例 | 说明 |
| ---- | ---- | ---- |
| 精确版本 |
@v1.0.0 | 锁定到指定 tag |
| 最新版本 | @latest | 获取最新 tag |
| 范围版本 | @^2.0.0 | semver 兼容 (>=2.0.0 <3.0.0) |
| 分支 | @branch:develop | 指定分支 |
| Commit | @commit:abc1234 | 指定 commit hash |
| (无) | - | 默认分支 (main) |配置
$3
`json
{
"skills": {
"planning": "github:user/planning-skill@v1.0.0",
"internal-tool": "internal:team/tool@latest"
},
"registries": {
"internal": "https://gitlab.company.com"
},
"defaults": {
"installDir": ".skills",
"targetAgents": ["cursor", "claude-code"],
"installMode": "symlink"
}
}
`$3
reskill 使用你已有的 git 凭证(SSH key 或 credential helper)。CI/CD 配置:
`bash
GitLab CI
git config --global url."https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.company.com/".insteadOf "https://gitlab.company.com/"
`多 Agent 支持
Skills 默认安装到
.skills/,可与任何 Agent 集成:| Agent | 路径 |
| -------------- | ------------------------------------- |
| Cursor |
.cursor/rules/ 或 .cursor/skills/ |
| Claude Code | .claude/skills/ |
| Codex | .codex/skills/ |
| Windsurf | .windsurf/skills/ |
| GitHub Copilot | .github/skills/ |发布 Skills
> 注意: 发布功能需要部署私有 registry 后才能使用,暂不对外开放。
将你的 skills 发布到 registry 供他人使用:
`bash
登录 registry
reskill login验证但不发布(预览模式)
reskill publish --dry-run发布 skill
reskill publish
`详细的发布指南请参考 CLI 规范。
环境变量
| 变量 | 说明 | 默认值 |
| ---- | ---- | ------ |
|
RESKILL_CACHE_DIR | 全局缓存目录 | ~/.reskill-cache |
| RESKILL_TOKEN | 认证令牌(优先于 ~/.reskillrc) | - |
| RESKILL_REGISTRY | 默认 registry URL | https://registry.reskill.dev |
| DEBUG | 启用调试日志 | - |
| NO_COLOR | 禁用彩色输出 | - |开发
`bash
安装依赖
pnpm install开发模式
pnpm dev构建
pnpm build运行测试
pnpm test运行集成测试
pnpm test:integration类型检查
pnpm typecheck
``reskill 的实现参考了以下优秀项目:
- add-skill by Vercel Labs
- skild by Peiiii
- openskills by Numman Ali
MIT