Remove the GitRanks promotion, keep community acknowledgments, and restore the previous star history chart.
14 KiB
skillshare
English · Deutsch · Español · Français · 日本語 · 한국어 · Português · 简体中文 · 繁體中文
你的 AI coding 環境,隨處可用。
在同一個地方管理 skills、agents、rules、MCP 連線與 hooks。
適用於 Claude Code、Codex、Pi、OpenCode 等工具。
官方網站 • 安裝 • 快速開始 • 功能重點 • 畫面截圖 • 桌面 App • 文件
Note
最新版本:v0.30.11 — 從 dashboard 分享你的 Pi 套件:Plugins 頁面的「分享」現在會在 plugin 之後列出 Pi 從 npm 安裝的套件,並複製一行把它們全部加入的指令,例如
skillshare plugin add npm:<package> --target pi -g --no-tui。「目標裡的 hook」對話框也能直接修改或移除 Antigravity 和 Copilot 的 hook,不需要先匯入。 plugin 指南 → · 更新紀錄 →
為什麼用 skillshare
切換 AI 工具,不該每次都重新設定環境。 skillshare 把 skills 與其他 AI 資源集中到由你掌控的地方。
- 換工具,繼續用你的 skills — 修改一次,再同步到 Claude Code、Codex、Pi 和你使用的其他工具。
- 換電腦,帶著環境走 — 用 Git 管理資源來源,在另一台電腦上 pull。
- 和團隊共用 — 專案資源與程式碼一起管理,共用 skills 透過 tracked repo 發布。
一位同事用 Claude Code,另一位用 Codex。把共用的程式碼審查清單放在專案的 .skillshare/ 中一起管理。新成員安裝專案宣告的 skills,再同步到設定好的工具,就不用從聊天紀錄複製指令。團隊 onboarding →
透過桌面 App 或 CLI 在本機管理,使用前稽核 skills,並選擇各工具接收哪些內容。
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更新到最新版。它會自動判斷你的安裝方式並處理後續步驟。
CLI:Nix
nix profile add github:runkids/skillshare
使用 nix profile upgrade skillshare 更新。需要啟用 flakes 的 Nix 2.30 以上版本;較舊的 Nix 或 Lix 請使用 nix profile install。NixOS 與 Home Manager 設定可以使用 flake 的 overlays.default。
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
運作方式
- 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 執行檔) |
功能重點
安裝與更新 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、Pi、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
Herdr 面板 — 在 Herdr 的 agents 旁使用 skillshare:更新、sync、經過 audit 的安裝和 source repository 都在一個面板裡
參與貢獻
歡迎貢獻!請先開 issue,再送出附測試的 draft PR。 環境設定請見 CONTRIBUTING.md。
git clone https://github.com/runkids/skillshare.git && cd skillshare
make check # format + lint + test
Tip
不知道從哪裡開始?看看 open issues,或試試 Playground,不需要任何設定就有開發環境。
貢獻者
社群致謝
感謝每一位回報問題、提出建議或協助測試修正的朋友。 英文版 README。
如果 skillshare 對你有幫助,歡迎給個 ⭐
Star History
授權
MIT





