Make the desktop app visible in the homepage, navigation, and README before CLI installation. Add localized installation guides and promotion copy across all five documentation languages, with Homebrew as the recommended macOS path.
14 KiB
skillshare
English · 日本語 · 한국어 · 简体中文 · 繁體中文
AI CLI 的 skills、agents、rules、commands 等資源共用單一來源。用桌面 App 管理,或用一個指令同步到所有工具,從個人使用到整個組織。
支援 Codex、Claude Code、OpenClaw、OpenCode 等 60 多種工具。
官方網站 • 安裝 • 快速開始 • 功能重點 • 畫面截圖 • 桌面 App • 文件
Note
最新版本:v0.23.0 — 管理與同步 global 和 project 範圍的原生 hooks;用
tools.allow與tools.deny選擇模型可使用的 MCP tools;並透過 dashboard 新增的 Hooks 頁面與 MCP 工具選擇介面完成設定。完整的新功能與修正見 Releases 和更新紀錄。
為什麼用 skillshare
每個 AI CLI 都有自己的 skills 目錄。 你在其中一個改了內容,忘了複製到另一個,最後搞不清楚哪份才是最新的。
skillshare 解決這個問題:
- 一份來源,所有 agent — 用
skillshare sync同步到 Claude、Cursor、Codex 等 60 多種工具 - Agent 管理 — 自訂 agent 和 skills 一起同步到支援 agent 的 target
- 不只是 skills — 用 extras 管理 rules、commands、prompts 和任何以檔案為主的資源
- MCP 連線 — 伺服器只定義一次,用
sync mcp寫進每個 Agent 自己的設定格式 - 完整 plugin — plugin 的 skills、hooks 和 MCP 設定保持完整,用
plugin選擇哪些工具要安裝 - 原生 hooks — 管理各 Agent 的 event 設定或 extension 程式碼,支援預覽、啟用/停用與復原。 hooks
- 從任何地方安裝 — GitHub、GitLab、Bitbucket、Azure DevOps、Gitea、CNB,或任何自架的 Git
- 內建安全檢查 — 使用前先稽核 skills 是否含有 prompt injection 或資料外洩的內容
- 適合團隊 — 專案的 skills 放在
.skillshare/,組織共用的 skills 透過 tracked repo 發布 - 本機、輕量 — 單一執行檔,沒有 registry,沒有遙測,可完全離線使用
- 細緻的篩選 — 用
.skillignore、SKILL.md 的targets,以及各 target 的 include/exclude,控制哪些 skills 到哪些 target
運作方式
- macOS / Linux:
~/.config/skillshare/ - Windows:
%AppData%\skillshare\
┌─────────────────────────────────────────────────────────────┐
│ Source Directory │
│ ~/.config/skillshare/skills/ ← skills (SKILL.md) │
│ ~/.config/skillshare/agents/ ← agents │
│ ~/.config/skillshare/extras/ ← rules, commands, etc. │
└─────────────────────────────────────────────────────────────┘
│ sync
┌───────────────┼───────────────┐
▼ ▼ ▼
┌───────────┐ ┌───────────┐ ┌───────────┐
│ Claude │ │ OpenCode │ │ OpenClaw │ ...
└───────────┘ └───────────┘ └───────────┘
| 平台 | Skills 來源 | Agents 來源 | Extras 來源 | 連結方式 |
|---|---|---|---|---|
| macOS/Linux | ~/.config/skillshare/skills/ |
~/.config/skillshare/agents/ |
~/.config/skillshare/extras/ |
Symlinks |
| Windows | %AppData%\skillshare\skills\ |
%AppData%\skillshare\agents\ |
%AppData%\skillshare\extras\ |
資料夾用 NTFS Junction(不需要管理員權限);檔案 symlink 需要開發人員模式,否則改為複製 |
| 命令式(每次個別安裝) | 宣告式(skillshare) | |
|---|---|---|
| 單一來源 | skills 各自複製,互不相關 | 一份來源,以 symlink(或複製)發布 |
| 新電腦的設定 | 手動重跑每一次安裝 | git clone 設定檔,再 sync |
| 安全稽核 | 無 | 內建 audit,install 和 update 時自動掃描 |
| 網頁儀表板 | 無 | skillshare ui |
| 執行環境相依 | Node.js + npm | 無(單一 Go 執行檔) |
CLI 與介面預覽
| Skill 詳細資訊 | 安全稽核 |
|---|---|
![]() |
![]() |
| 網頁儀表板 | 網頁 Skills 頁面 |
|---|---|
![]() |
![]() |
安裝
Tip
用桌面 App 管理 skillshare。 下載 Skillshare App,支援 macOS(Apple Silicon)、Windows 與 Linux。首次啟動會引導你安裝或選取 CLI、選擇 AI 工具,並完成第一次同步。安裝指南。
桌面 App — 圖形化設定與日常管理
Skillshare App 把技能、代理、MCP 與 hooks 整合在桌面視窗中。安裝並開啟 App,再依首次啟動的引導完成設定。
macOS(Apple Silicon),使用 Homebrew:
brew tap runkids/tap
brew install --cask skillshare-app
Windows/Linux,或手動安裝 macOS 版本:下載最新 App 安裝包。各平台的詳細說明請見桌面 App 安裝指南。
CLI:macOS / Linux
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
腳本預設安裝到 ~/.local/bin,正常安裝與更新不需要 sudo。只有安裝器顯示 PATH 設定提示時,才需要依提示設定後再執行 skillshare。可把提示的指令加入 shell 設定檔(例如 ~/.zshrc 或 ~/.bashrc),讓之後開啟的終端機也能使用。可用 INSTALL_DIR 指定其他安裝位置。
Windows PowerShell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
CLI:Homebrew
brew install skillshare
提示: 執行
skillshare upgrade更新到最新版。它會自動判斷你的安裝方式並處理後續步驟。
GitHub Actions
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
所有選項(audit、project 模式、鎖定版本)請見 setup-skillshare。
簡寫(選用)
在 shell 設定檔(~/.zshrc 或 ~/.bashrc)加上 alias:
alias ss='skillshare'
快速開始
skillshare init # 建立設定檔、來源目錄,並偵測已安裝的 target
skillshare sync # 把 skills 同步到所有 target
功能重點
安裝與更新 skills — 來源可以是 GitHub、GitLab 或任何 Git 主機
skillshare install github.com/reponame/skills
skillshare update --all
skillshare target claude --mode copy # symlink 不能用的時候
Symlink 有問題? — 個別 target 可以改用 copy 模式
skillshare target <name> --mode copy
skillshare sync
安全稽核 — 在 skills 進到 agent 之前先掃描
skillshare audit
專案 skills — 跟著 repo 走,和程式碼一起 commit
skillshare init -p && skillshare sync
Agents — 把自訂 agent 同步到支援 agent 的 target
skillshare sync agents # 只同步 agents
skillshare sync --all # skills、agents、extras、MCP、hooks 一起同步
Extras — 管理 rules、commands、prompts 等資源
skillshare extras init rules # 建立名為 "rules" 的 extra
skillshare sync --all # skills、agents、extras、MCP、hooks 一起同步
skillshare extras collect rules # 把本機檔案收回來源
MCP 連線 — 設定一次,Claude Code、Codex、Cursor、VS Code、OpenCode 等工具都能用
skillshare mcp add # 引導式設定,輸入 URL 或貼上 JSON
skillshare sync mcp --dry-run # 預覽各工具設定檔會有的變更
skillshare sync mcp # 套用連線設定
定義可以放在 config.yaml,或另外引用一個 mcp.yaml。
範例、環境變數引用,以及匯入既有連線的方式,請見 MCP 設定。
管理原生 hooks,管理操作不執行 hook:
skillshare hooks add check --file ./check.yaml
skillshare hooks sync --dry-run
skillshare hooks sync
Plugins — 安裝完整的 plugin,並選擇哪些工具要安裝
skillshare plugin add # 引導式:來源、plugin、target、確認
skillshare plugin add owner/repo --target claude --target codex --no-tui
skillshare sync plugins --dry-run # plugin 的同步獨立於 sync --all
工具裡已經裝好的 plugin 可以用 plugin import 納入管理。
請見跨工具管理 plugin。
Shell 自動補全 — 用 Tab 補全指令、flag 和子指令
skillshare completion bash --install # 也支援 zsh、fish、powershell、nushell
本機檢查點 — commit 來源目錄的變更,但不 push
skillshare commit -m "Update review skill"
skillshare commit --dry-run
網頁儀表板 — 視覺化的控制面板
skillshare ui
參與貢獻
歡迎貢獻!請先開 issue,再送出附測試的 draft PR。 環境設定請見 CONTRIBUTING.md。
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
Tip
不知道從哪裡開始?看看 open issues,或試試 Playground,不需要任何設定就有開發環境。
貢獻者
感謝每一位讓 skillshare 變得更好的人。完整名單在英文版 README。
如果 skillshare 對你有幫助,歡迎給個 ⭐
Star History
授權
MIT





