Files
skillshare/README-zh-TW.md
Willie f9f59b432b docs(readme): link directly to GitHub contributors
Remove the GitRanks promotion, keep community acknowledgments, and restore the previous star history chart.
2026-11-19 01:12:00 +08:00

14 KiB
Raw Permalink Blame History

skillshare

skillshare

English · Deutsch · Español · Français · 日本語 · 한국어 · Português · 简体中文 · 繁體中文

Website License: MIT Release Downloads Platform Ask DeepWiki

Star on GitHub

runkids%2Fskillshare | Trendshift runkids%2Fskillshare | Trendshift

你的 AI coding 環境,隨處可用。
在同一個地方管理 skills、agents、rules、MCP 連線與 hooks。
適用於 Claude Code、Codex、Pi、OpenCode 等工具。

官方網站 • 安裝 • 快速開始 • 功能重點 • 畫面截圖 • 桌面 App • 文件

skillshare demo

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 詳細資訊 安全稽核
Skill 詳細資訊 安全稽核
網頁儀表板 網頁 Skills 頁面
網頁儀表板 網頁 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 都在一個面板裡

設定 Herdr 面板 →

所有指令與指南 →

參與貢獻

歡迎貢獻!請先開 issue,再送出附測試的 draft PR。 環境設定請見 CONTRIBUTING.md。

git clone https://github.com/runkids/skillshare.git && cd skillshare
make check  # format + lint + test

Tip

不知道從哪裡開始?看看 open issues,或試試 Playground,不需要任何設定就有開發環境。

貢獻者

在 GitHub 查看貢獻者

社群致謝

感謝每一位回報問題、提出建議或協助測試修正的朋友。 英文版 README。


如果 skillshare 對你有幫助,歡迎給個 ⭐

Star History

Star History Chart

授權

MIT