skill-linker 3.0.0 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +44 -13
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,11 +1,15 @@
1
1
  # AI Agent Skill Installer (skill-linker)
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/skill-linker.svg)](https://www.npmjs.com/package/skill-linker)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
6
+
3
7
  一個現代化的互動式 CLI 工具,用於將 AI Agent Skills 快速連結(Symlink)到各種 AI Agent 的專案或全域目錄中。
4
8
 
5
9
  ## ✨ 功能特色
6
10
 
7
11
  - **現代化 TUI 介面**:使用 `prompts` 提供流暢的互動體驗。
8
- - **模糊搜尋 (Fuzzy Search)**:在選擇 Skill 時可輸入關鍵字快速過濾。
12
+ - **模糊搜尋 (Fuzzy Search)**:在選擇 Repository 時,直接輸入文字即可即時過濾清單。
9
13
  - **智慧偵測**:自動偵測系統中已安裝的 Agent,並在選單中預設勾選。
10
14
  - **多 Agent 支援**:支援 Claude Code, GitHub Copilot, Antigravity, Cursor, Windsurf, OpenCode, Gemini CLI 等。
11
15
  - **雙重範圍 (Scope)**:可選擇安裝到當前 `專案目錄 (Project)` 或 `全域目錄 (Global)`。
@@ -17,13 +21,18 @@
17
21
  ### 方式 1:使用 npx (推薦)
18
22
 
19
23
  ```bash
20
- # 啟動互動式安裝介面
24
+ # 啟動互動式安裝介面 (選擇本地或新 Clone)
21
25
  npx skill-linker
22
26
 
27
+ # 瀏覽並從庫中 (AgentSkills/) 挑選已下載的 Skill
28
+ npx skill-linker list
29
+ # 或使用縮寫
30
+ npx skill-linker -l
31
+
23
32
  # 從 GitHub Clone 並安裝
24
33
  npx skill-linker --from https://github.com/user/my-skill
25
34
 
26
- # 指定本地路徑
35
+ # 指定本地路徑 (如果是自己 clone 下來的指定目錄)
27
36
  npx skill-linker /path/to/my-skill
28
37
  ```
29
38
 
@@ -48,25 +57,35 @@ Arguments:
48
57
 
49
58
  Options:
50
59
  -V, --version 顯示版本號
51
- --from <github-url> GitHub Clone Skill 後再連結
52
- -l, --list 列出庫中的 Skills (可互動選擇)
60
+ --from <github-url> 先從 GitHub Clone Skill 後再進行連結
61
+ -l, --list 列出庫中可用的 Skills (可互動選擇)
53
62
  -h, --help 顯示說明
54
63
 
55
64
  Commands:
56
- list 列出所有庫中的 Repos 與其 Skills
65
+ list 列出庫中所有可用的 Repos 與其 Skills
57
66
  ```
58
67
 
59
68
  ### 📋 瀏覽模式 (List Mode)
60
69
 
61
- 使用 `list` 子指令或 `-l` 參數可以啟動兩層式的互動瀏覽:
70
+ 如果您想從之前透過 `--from` 下載過的庫 (`~/Documents/AgentSkills`) 中挑選 Skill 來安裝,請使用 `list` 子指令:
62
71
 
63
72
  ```bash
64
73
  npx skill-linker list
65
74
  ```
66
75
 
76
+ 或使用選項:
77
+ ```bash
78
+ npx skill-linker -l
79
+ ```
80
+
67
81
  1. **第一層**:選擇已 Clone 的 Repository (會標註是否有 `skills/` 子目錄)。
68
82
  2. **第二層**:如果該 Repo 包含多個 Skills,會進階列出供您查看。
69
83
 
84
+ > 💡 **提示**:如果您已經手動 `git clone` 了某個 Skill Repo,也可以直接指定路徑安裝:
85
+ > ```bash
86
+ > npx skill-linker /path/to/your-cloned-repo
87
+ > ```
88
+
70
89
  ## 📂 Skill Library 管理
71
90
 
72
91
  當您使用 `--from` 參數時,Skills 會自動存放到 `~/Documents/AgentSkills`,並以 **owner/repo** 結構分層:
@@ -94,17 +113,29 @@ npx skill-linker list
94
113
 
95
114
  ## 📦 推薦的 Public Skill Repos
96
115
 
97
- | Repo | 說明 |
98
- |------|------|
99
- | [anthropics/skills](https://github.com/anthropics/skills) | Claude 官方 Skills (pdf, docx, pptx, xlsx...) |
100
- | [moltbot/skills](https://github.com/moltbot/skills) | 各種封存的 AI Agent Skills (來自 clawdhub.com) |
116
+ ### Claude 官方 Skills (pdf, docx, pptx, xlsx...)
117
+ [anthropics/skills](https://github.com/anthropics/skills)
118
+ ```bash
119
+ npx skill-linker --from https://github.com/anthropics/skills
120
+ ```
121
+
122
+ ### moltbot 的 AI Agent Skills (來自 clawdhub.com)
123
+ [moltbot/skills](https://github.com/moltbot/skills)
124
+ ```bash
125
+ npx skill-linker --from https://github.com/moltbot/skills
126
+ ```
127
+
128
+ ### 精選的 AI Skills 工具箱
129
+ [obra/superpowers](https://github.com/obra/superpowers)
130
+ ```bash
131
+ npx skill-linker --from https://github.com/obra/superpowers
132
+ ```
101
133
 
102
134
  ## ⚠️ 注意事項
103
135
 
104
136
  1. **權限問題**:在建立 Symlink 時,請確保您有對應目錄的寫入權限。
105
- 2. **環境需求**:需安裝 Node.js 14.0.0 以上版本。
137
+ 2. **環境需求**:需安裝 Node.js 18.0.0 以上版本。
106
138
 
107
139
  ## 授權
108
140
 
109
141
  MIT License
110
-
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skill-linker",
3
- "version": "3.0.0",
3
+ "version": "3.0.5",
4
4
  "description": "Interactive CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
@@ -36,7 +36,7 @@
36
36
  "url": "git+https://github.com/raybird/skill-linker.git"
37
37
  },
38
38
  "engines": {
39
- "node": ">=14.0.0"
39
+ "node": ">=18.0.0"
40
40
  },
41
41
  "files": [
42
42
  "bin/",