AI Agent Skill Installer (skill-linker)

一個現代化的 CLI 工具，用於將 AI Agent Skills 快速連結（Symlink）到各種 AI Agent 的專案或全域目錄中。

✨ 功能特色

• CLI 優先設計：專為 AI Agent 打造的命令列介面，無需互動問答。
• 自動化流程：支援自動 Clone、安裝、覆寫。
• 多 Agent 支援：支援 Claude Code, GitHub Copilot, Antigravity, Cursor, Windsurf, OpenCode, Gemini CLI 等。
• 雙重範圍 (Scope)：可選擇安裝到當前 專案目錄 (Project) 或 全域目錄 (Global)。
• 自動 Clone：支援從 GitHub Clone 並自動處理 Multi-skill Repos。
• 完全相容 npx：無需安裝，隨插即用。

🚀 快速開始

方式 1：使用 npx (推薦)

# 安裝技能（需要 --skill 或 --from）
npx /app/workspace/projects/skill-linker install --skill <路徑> --agent opencode --scope both --yes
npx skill-linker install --from https://github.com/anthropics/skills --agent claude --scope both

# 列出已安裝的 Repos
npx skill-linker list
npx skill-linker list --repo skill-name
npx skill-linker list --repo skill-name --json

方式 2：本地開發/安裝

git clone https://github.com/raybird/skill-linker.git
cd skill-linker
npm install
npm link # 之後可直接使用 skill-linker 指令

🛠️ 命令說明

Usage: skill-linker [command]

CLI to link AI Agent Skills to various agents

Commands:
  install    Install a skill to specified agents
  list       List available skills in library

Options:
  -V, --version    顯示版本號
  -h, --help       顯示說明

install 命令

Usage: skill-linker install --skill <path>

Options:
  --skill <path>         指定本地 Skill 目錄路徑（必需）
  --from <github-url>    從 GitHub Clone 後再進行連結
  -a, --agent <names>    指定 Agent 名稱（opencode, claude, cursor 等）
  -s, --scope <scope>    範圍：project, global, both（預設 both）
  -y, --yes              自動覆寫已存在的連結

範例：

# 指定路徑安裝到 opencode
npx skill-linker install --skill /path/to/skill --agent opencode

# 從 GitHub Clone 並安裝到多個 Agents
npx skill-linker install --from https://github.com/anthropics/skills --agent claude cursor --scope both

# 安裝到所有已偵測到的 Agents
npx skill-linker install --skill /path/to/skill --scope both --yes

list 命令

Usage: skill-linker list [options]

Options:
  -r, --repo <name>   指定 Repository 名稱
  --json              JSON 輸出格式

範例：

# 列出所有 Repos
npx skill-linker list

# 列出特定 Repo 的 Skills
npx skill-linker list --repo skill-name

# JSON 輸出
npx skill-linker list --repo skill-name --json

📂 Skill Library 管理

當您使用 --from 參數時，Skills 會自動存放到 ~/Documents/AgentSkills，並以 owner/repo 結構分層：

~/Documents/AgentSkills/
├── anthropics/
│   └── skills/          # https://github.com/anthropics/skills
└── your-org/
    └── your-skill/      # https://github.com/your-org/your-skill

🛠️ 支援的 Agent 與路徑

| 平台 / 工具 | 專案目錄 | 全域目錄 | | ---------------------- | ------------------- | ------------------------------- | | Claude Code | .claude/skills/ | ~/.claude/skills/ | | GitHub Copilot | .github/skills/ | ~/.copilot/skills/ | | Google Antigravity | .agent/skills/ | ~/.gemini/antigravity/skills/ | | Cursor | .cursor/skills/ | ~/.cursor/skills/ | | OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ | | OpenAI Codex | .codex/skills/ | ~/.codex/skills/ | | Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ | | Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ |

📦 推薦的 Public Skill Repos

Claude 官方 Skills (pdf, docx, pptx, xlsx...)

anthropics/skills

npx skill-linker install --from https://github.com/anthropics/skills --agent claude

moltbot 的 AI Agent Skills (來自 clawdhub.com)

moltbot/skills

npx skill-linker install --from https://github.com/moltbot/skills --agent opencode

精選的 AI Skills 工具箱

obra/superpowers

npx skill-linker install --from https://github.com/obra/superpowers --agent claude cursor

⚠️ 注意事項

1. 權限問題：在建立 Symlink 時，請確保您有對應目錄的寫入權限。
2. 環境需求：需安裝 Node.js 18.0.0 以上版本。

授權

MIT License