reskill 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kanyun-ai-infra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,199 @@
+# reskill
+
+**AI Skills Package Manager** - Git-based skills management for AI agents
+
+[![npm version](https://img.shields.io/npm/v/reskill.svg)](https://www.npmjs.com/package/reskill)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 概述
+
+reskill 是一个基于 Git 的 AI Skills 包管理系统，类似 npm/Go modules 的架构，实现 AI Skills 的版本化管理、共享和复用。
+
+## 特性
+
+- 🚀 **Git 即 Registry** - 无需额外服务，git 仓库就是 skill 存储源
+- 📦 **声明式配置** - skills.json 清晰表达项目依赖
+- 🔒 **版本锁定** - 支持精确版本、范围版本、latest
+- 🔗 **本地开发** - 支持 link 本地 skill 进行开发调试
+- ⚡ **全局缓存** - 避免重复下载，加速安装
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g reskill
+
+# 或使用 npx
+npx reskill <command>
+```
+
+## 快速开始
+
+```bash
+# 1. 初始化项目
+reskill init
+
+# 2. 安装 skill
+reskill install github:user/my-skill@v1.0.0
+
+# 3. 列出已安装的 skills
+reskill list
+```
+
+## 命令
+
+### 初始化
+
+```bash
+reskill init                    # 创建 skills.json
+reskill init --name my-project  # 指定项目名称
+reskill init --registry gitlab  # 使用 gitlab 作为默认 registry
+```
+
+### 安装
+
+```bash
+reskill install                          # 安装 skills.json 中的所有 skills
+reskill install <skill>                  # 安装单个 skill
+reskill install github:user/skill@v1.0.0 # 安装指定版本
+reskill install user/skill@latest        # 安装最新版本
+reskill install user/skill@^1.0.0        # 安装 semver 范围
+reskill install --force                  # 强制重新安装
+```
+
+### 管理
+
+```bash
+reskill list                    # 列出已安装 skills
+reskill list --json             # JSON 格式输出
+reskill info <skill>            # 查看 skill 详情
+reskill update                  # 更新所有 skills
+reskill update <skill>          # 更新单个 skill
+reskill outdated                # 检查过期 skills
+reskill uninstall <skill>       # 卸载 skill
+```
+
+### 开发
+
+```bash
+reskill link <path>             # 链接本地 skill（开发用）
+reskill link <path> --name xxx  # 链接并指定名称
+reskill unlink <skill>          # 取消链接
+```
+
+## 配置文件
+
+### skills.json
+
+```json
+{
+  "name": "my-project",
+  "skills": {
+    "planning": "github:user/planning-skill@v1.0.0",
+    "code-review": "gitlab:team/code-review@latest"
+  },
+  "defaults": {
+    "registry": "github",
+    "installDir": ".skills"
+  },
+  "registries": {
+    "internal": "https://gitlab.company.com"
+  }
+}
+```
+
+### 版本规范
+
+| 格式 | 示例 | 说明 |
+|-----|------|------|
+| 精确版本 | `@v1.0.0` | 锁定到指定 tag |
+| 最新版本 | `@latest` | 获取最新 tag |
+| 范围版本 | `@^2.0.0` | semver 兼容（>=2.0.0 <3.0.0） |
+| 分支 | `@branch:develop` | 指定分支 |
+| Commit | `@commit:abc1234` | 指定 commit hash |
+
+### 仓库引用格式
+
+```
+完整格式: <registry>:<owner>/<repo>@<version>
+简写格式: <owner>/<repo>@<version>  (使用默认 registry)
+
+示例:
+  github:user/skill@v1.0.0
+  gitlab:group/skill@latest
+  gitlab.company.com:team/skill@v1.0.0
+  user/skill@v1.0.0  → 使用 defaults.registry
+```
+
+## 目录结构
+
+安装后的项目结构：
+
+```
+my-project/
+├── skills.json          # 依赖声明
+├── skills.lock          # 版本锁定
+└── .skills/             # 安装目录
+    ├── planning/
+    │   ├── skill.json
+    │   └── SKILL.md
+    └── code-review/
+        ├── skill.json
+        └── SKILL.md
+```
+
+## Skill 仓库结构
+
+每个 Skill 仓库应遵循以下结构：
+
+```
+my-skill/
+├── skill.json           # 元数据（必需）
+├── SKILL.md             # 主入口文档（必需）
+├── README.md            # 仓库说明
+└── templates/           # 模板文件（可选）
+```
+
+### skill.json
+
+```json
+{
+  "name": "my-skill",
+  "version": "1.0.0",
+  "description": "A skill for ...",
+  "author": "Your Name",
+  "license": "MIT",
+  "entry": "SKILL.md",
+  "keywords": ["ai", "skill"]
+}
+```
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|-----|------|-------|
+| `SKPM_CACHE_DIR` | 全局缓存目录 | `~/.reskill-cache` |
+| `DEBUG` | 启用调试日志 | - |
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发模式
+pnpm dev
+
+# 构建
+pnpm build
+
+# 运行测试
+pnpm test
+
+# 类型检查
+pnpm typecheck
+```
+
+## License
+
+MIT

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,9 @@
+export { initCommand } from './init.js';
+export { installCommand } from './install.js';
+export { listCommand } from './list.js';
+export { infoCommand } from './info.js';
+export { updateCommand } from './update.js';
+export { outdatedCommand } from './outdated.js';
+export { uninstallCommand } from './uninstall.js';
+export { linkCommand, unlinkCommand } from './link.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/cli/commands/info.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * info 命令 - 查看 skill 详情
+ */
+export declare const infoCommand: Command;
+export default infoCommand;
+//# sourceMappingURL=info.d.ts.map

package/dist/cli/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAmDpB,CAAC;AAEL,eAAe,WAAW,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * init 命令 - 初始化 skills.json
+ */
+export declare const initCommand: Command;
+export default initCommand;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAgCpB,CAAC;AAEL,eAAe,WAAW,CAAC"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+/**
+ * install 命令 - 安装 skill
+ *
+ * 支持两种安装模式:
+ * - 项目安装 (默认): 安装到 .skills/ 目录，更新 skills.json 和 skills.lock
+ * - 全局安装 (-g): 安装到 ~/.claude/skills/，不更新配置文件
+ */
+export declare const installCommand: Command;
+export default installCommand;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,SAoEvB,CAAC;AAEL,eAAe,cAAc,CAAC"}

package/dist/cli/commands/link.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare const linkCommand: Command;
+export declare const unlinkCommand: Command;
+export default linkCommand;
+//# sourceMappingURL=link.d.ts.map

package/dist/cli/commands/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,eAAO,MAAM,WAAW,SAAU,CAAC;AACnC,eAAO,MAAM,aAAa,SAAY,CAAC;AACvC,eAAe,WAAW,CAAC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * list 命令 - 列出已安装的 skills
+ */
+export declare const listCommand: Command;
+export default listCommand;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;GAEG;AACH,eAAO,MAAM,WAAW,SAmCpB,CAAC;AAEL,eAAe,WAAW,CAAC"}

package/dist/cli/commands/outdated.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * outdated 命令 - 检查过期的 skills
+ */
+export declare const outdatedCommand: Command;
+export default outdatedCommand;
+//# sourceMappingURL=outdated.d.ts.map

package/dist/cli/commands/outdated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outdated.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/outdated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,eAAO,MAAM,eAAe,SA6DxB,CAAC;AAEL,eAAe,eAAe,CAAC"}

package/dist/cli/commands/uninstall.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * uninstall 命令 - 卸载 skill
+ */
+export declare const uninstallCommand: Command;
+export default uninstallCommand;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/cli/commands/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/uninstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;GAEG;AACH,eAAO,MAAM,gBAAgB,SAezB,CAAC;AAEL,eAAe,gBAAgB,CAAC"}

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * update 命令 - 更新 skill
+ */
+export declare const updateCommand: Command;
+export default updateCommand;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,eAAO,MAAM,aAAa,SAiCtB,CAAC;AAEL,eAAe,aAAa,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}