@boses/skillink 0.0.0 → 1.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 yliu
-
-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.
+MIT License
+
+Copyright (c) 2026 yliu
+
+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

@@ -1,57 +1,50 @@
 # Skillink 🚀
 
-**Skillink** 是一个为 AI 时代打造的技能管理工具。它允许你在一个统一的目录（`.agents/skills`）中编写 AI 技能（Skills），并利用符号链接（Symlink/Junction）技术，即时同步到各种 AI 工具（如 Cursor、Windsurf、VSCode、Gemini）的配置目录中。
+[English](./README.md) | [简体中文](./README.zh-CN.md)
 
-> **核心理念：一次编写，处处生效。**
+**Skillink** is a skill linker for AI tools.  
+Write skills in one place (`.agents/skills`) and sync to multiple tool directories with symlinks/junctions.
 
-## ✨ 特性
+> Core idea: **Write once, use everywhere.**
 
--   **🎯 极简架构**：基于 Node.js 20+ 和 TypeScript 5.x，性能卓越。
--   **🔗 零克隆开销**：采用符号链接技术，目标目录的文件只是源文件的引用。修改源文件，AI 工具立即感知，无需等待同步。
--   **🛠️ 极致 DX**：
-    -   **交互式初始化**：一键引导配置。
-    -   **自动探测与创建**：自动管理 AI 工具的配置目录。
-    -   **实时监视**：支持 `--watch` 模式，动态响应技能的增删。
--   **🛡️ 安全可靠**：仅操作符号链接，不轻易改动或删除用户的原始文件。
+## Features
 
-## 📦 安装
+- Minimal architecture with Node.js 20+ and TypeScript
+- Symlink-based sync (no copy, instant effect)
+- Interactive `init` flow
+- `sync --watch` for real-time skill folder changes
+- Safe clean behavior (only removes links under source boundary)
+- CLI localization via config (`en` / `zh-CN`)
 
-推荐全局安装以便在任何项目中使用：
+## Install
 
-```bash
-# 使用 pnpm
-pnpm add -g @boses/skillink
-
-# 使用 npm
-npm install -g @boses/skillink
+Install as a dev dependency:
 
-# 使用 yarn
-yarn global add @boses/skillink
-```
+```bash
+# pnpm
+pnpm add -D @boses/skillink
 
-或者使用 `npx` 快速试用：
+# npm
+npm install -D @boses/skillink
 
-```bash
-npx @boses/skillink init
+# yarn
+yarn add -D @boses/skillink
 ```
 
-## 🚀 快速开始
+## Quick Start
 
-### 1. 初始化项目
-
-在项目根目录下运行：
+### 1) Initialize
 
 ```bash
-skillink init
+npx skillink init
 ```
 
-按照交互提示选择你正在使用的 AI 工具。该命令会自动：
-- 创建 `.agents/skills` 目录并添加一个示例技能。
-- 生成 `skillink.config.ts` 配置文件。
+The first step in `init` asks language (`English / 简体中文`), then it creates:
 
-### 2. 编写技能
+- `.agents/skills` (with an example skill)
+- `skillink.config.ts`
 
-在 `.agents/skills` 目录下创建子文件夹，并在其中编写 `SKILL.md`：
+### 2) Write skills
 
 ```text
 .agents/skills/
@@ -59,53 +52,60 @@ skillink init
     └── SKILL.md
 ```
 
-### 3. 同步到工具
+### 3) Sync
 
 ```bash
-skillink sync
+npx skillink sync
 ```
 
-想要在开发时自动同步新增的技能？运行：
+Watch mode:
 
 ```bash
-skillink sync --watch
+npx skillink sync --watch
 ```
 
-## 🛠️ 命令详解
+## Commands
 
-| 命令 | 描述 |
-| :--- | :--- |
-| `init` | 初始化项目环境，生成 `.agents/skills` 和配置文件。 |
-| `sync` | 将技能同步到所有配置的目标工具中。支持 `-w, --watch` 模式。 |
-| `status` | 检查并显示当前所有技能与目标工具的同步状态。 |
-| `clean` | 移除所有由 Skillink 创建的符号链接，恢复环境。 |
+| Command  | Description                                                                          |
+| :------- | :----------------------------------------------------------------------------------- |
+| `init`   | Initialize project and create config.                                                |
+| `sync`   | Sync skills to all enabled targets (`--watch` supported).                            |
+| `status` | Show detailed sync status.                                                           |
+| `clean`  | Remove generated symlinks from configured targets.                                   |
+| `check`  | Check updates by semantic versions from npm `versions` (no `latest` tag dependency). |
 
-## ⚙️ 配置说明 (`skillink.config.ts`)
+## Configuration (`skillink.config.ts`)
 
 ```typescript
-import { defineConfig } from 'skillink';
+import { defineConfig } from '@boses/skillink';
 
 export default defineConfig({
-  // 技能源目录
+  // CLI locale: 'en' | 'zh-CN' (default: 'en')
+  locale: 'en',
+  // Skills source directory
   source: '.agents/skills',
-  // 同步目标列表
+  // Sync targets
   targets: [
     {
       name: 'cursor',
       path: '.cursor/rules',
-      // 是否启用该目标（默认为 true）
-      // 设置为 false 后，sync 和 status 命令将忽略此目标
       enabled: true,
     },
     {
       name: 'gemini',
-      path: '.gemini/modules',
+      path: '.gemini/skills',
       enabled: true,
-    }
+    },
   ],
 });
 ```
 
-## 📄 许可证
+## Git Recommendation
+
+- Commit: `skillink.config.ts`, `.agents/skills/**`
+- Avoid committing generated link targets (for example: `.cursor/rules`, `.gemini/skills`)
+- `init` will remind you to add target directories to `.gitignore`
+
+## License
 
-MIT
+MIT

package/README.zh-CN.md

@@ -0,0 +1,111 @@
+# Skillink 🚀
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+**Skillink** 是一个 AI Skills 链接工具。  
+你可以在统一目录（`.agents/skills`）编写技能，并通过符号链接（Symlink/Junction）同步到多个 AI 工具目录。
+
+> 核心理念：**一次编写，处处生效。**
+
+## 特性
+
+- Node.js 20+ + TypeScript 的简洁架构
+- 基于符号链接同步，零拷贝、即时生效
+- 交互式 `init` 初始化流程
+- `sync --watch` 支持实时监听技能目录变化
+- 安全清理策略（仅清理位于 source 边界内的链接）
+- 支持 CLI 国际化输出（`en` / `zh-CN`）
+
+## 安装
+
+推荐安装为开发依赖：
+
+```bash
+# pnpm
+pnpm add -D @boses/skillink
+
+# npm
+npm install -D @boses/skillink
+
+# yarn
+yarn add -D @boses/skillink
+```
+
+## 快速开始
+
+### 1）初始化
+
+```bash
+npx skillink init
+```
+
+`init` 第一步会先询问语言（`English / 简体中文`），然后自动创建：
+
+- `.agents/skills`（包含示例技能）
+- `skillink.config.ts`
+
+### 2）编写技能
+
+```text
+.agents/skills/
+└── react-expert/
+    └── SKILL.md
+```
+
+### 3）同步
+
+```bash
+npx skillink sync
+```
+
+监听模式：
+
+```bash
+npx skillink sync --watch
+```
+
+## 命令
+
+| 命令     | 说明                                                               |
+| :------- | :----------------------------------------------------------------- |
+| `init`   | 初始化项目并生成配置。                                             |
+| `sync`   | 同步技能到所有启用目标（支持 `--watch`）。                         |
+| `status` | 显示详细同步状态。                                                 |
+| `clean`  | 清理配置目标中的已生成符号链接。                                   |
+| `check`  | 基于 npm `versions` 的语义化版本检查更新（不依赖 `latest` 标签）。 |
+
+## 配置说明（`skillink.config.ts`）
+
+```typescript
+import { defineConfig } from '@boses/skillink';
+
+export default defineConfig({
+  // CLI 语言: 'en' | 'zh-CN'（默认: 'en'）
+  locale: 'en',
+  // 技能源目录
+  source: '.agents/skills',
+  // 同步目标
+  targets: [
+    {
+      name: 'cursor',
+      path: '.cursor/rules',
+      enabled: true,
+    },
+    {
+      name: 'gemini',
+      path: '.gemini/skills',
+      enabled: true,
+    },
+  ],
+});
+```
+
+## Git 建议
+
+- 推荐提交：`skillink.config.ts`、`.agents/skills/**`
+- 不建议提交：链接产物目录（如 `.cursor/rules`、`.gemini/skills`）
+- `init` 完成后会提示将目标目录加入 `.gitignore`
+
+## 许可证
+
+MIT

package/dist/bin/skillink.js

@@ -1,8 +1,4 @@
 #!/usr/bin/env node
 import { createRequire } from 'module';const require = createRequire(import.meta.url);
-import {
-  init_esm_shims
-} from "../chunk-ZEFDUUIX.js";
-
-// src/bin/skillink.ts
-init_esm_shims();
+import "../chunk-2UL2JQ4R.js";
+import "../chunk-AGAXTALJ.js";