Skillshare CLI
使用 Skillshare 維護來源並將資源分發到已設定的目標。
請僅閱讀與請求操作相關的參考資料；路由表如下。
如果已安裝版本與這些範例不同，請查閱 skillshare <command> --help。
範圍與資源選取
- 全域設定檔：
~/.config/skillshare/config.yaml。專案設定檔：.skillshare/config.yaml或skillshare/config.yaml；當兩者同時存在時，隱藏檔案獲勝。當位置很重要時，請明確使用-g或-p，不要依賴自動偵測。 - 技能是包含
SKILL.md的目錄；代理是單一的 Markdown 檔案。 來源路徑可以自訂。請使用已設定的來源，不要假定預設值。 - 被追蹤的
skills/<known-agent>/<skill-path>/SKILL.md副本構成每個儲存庫/前綴/後綴的一個邏輯技能。合併/複製會選取精確的代理變體（包括別名和帳戶agent:身分）。識別需要兩個不同的規範代理具有相同的後綴。共享一個資料夾的兼容目標會選取其代理身分的聯集；僅限通用的目標不會推斷代理。狀態會計算邏輯技能和實體變體；列表和同步操作會保留實體名稱。明確的目標/覆寫和實體過濾器仍然適用。整個目錄的符號連結模式會公開所有變體。請參閱 sync.md。 - 對代理使用原生代理目標。如需任意檔案資源或需要扁平化/內容轉換時，請使用擴充功能；
extension:僅適用於擴充功能目標。 - 共享記憶體筆記位於
memory擴充功能中。使用extras memory來管理 Markdown 筆記和閱讀指引；支援巢狀路徑，例如wiki/architecture.md。 請參閱 extras.md 以了解範圍、版本檢查和代理設定。 如需工作階段回顧或在已儲存的筆記之間進行 Dreaming，請閱讀 memory-review.md。主機代理會執行回顧； Skillshare 絕不會啟動或排程代理。 - MCP 使用自己的接收目標和來源定義。在編輯 MCP 設定或匯入原生設定之前，請閱讀 mcp.md。其代理說明涵蓋了專屬於 Claude Code、Codex、OpenCode 和 Pi 的內容：範圍和檔案、它們拒絕的名稱和憑證、Pi 的內建 MCP 和
piOptions、OMP 的原生 MCP 和保留的啟用/停用列表、可攜式tools政策、 從 0.22 升級 Pi 設定、在一個專案中關閉全域伺服器、從一個設定檔為多個資料夾設定mcp.projects，以及為無法到達同步技能資料夾的代理提供mcp serve。 - 外掛程式將它們的原生組件整合在一起。請閱讀 plugins.md 以了解安裝、匯入、同步選取、更新以及在 Claude、Codex、Cursor、Antigravity、Pi、OMP 和 OpenCode 之間的原生相容性限制，包括來自 pi.dev 的 Pi 套件 以及 OMP 市集外掛程式和獨立擴充功能選取。
- 鉤子保留每個代理的原生事件映射或擴充功能/外掛程式程式碼。在匯入、同步或復原之前，請閱讀 hooks.md。
執行規則
- 選擇非互動輸入。 提供特定命令支援的名稱和選取標誌。使用
--no-tui獲取純文字輸出，或在支援的地方使用--json。 不要僅僅為了避免提示而添加--force：它可能會覆寫衝突或繞過稽核。 - 將預覽與寫入分開。 在支援的地方使用
--dry-run。更改技能或代理後，同步所需的資源和範圍。除非提供了--sync，否則 MCP 和鉤子的變更僅儲存來源；sync --all也包含擴充功能、MCP 和鉤子，但排除外掛程式。 - 檢查稽核區塊。 在選擇覆寫之前先檢視發現結果。
install --json允許覆寫，並在未指定技能/代理過濾器時全選，但會保留稽核閘道；它不僅僅是輸出格式。在使用它進行自動化之前，請閱讀 install.md 和 audit.md。 - 使用匹配的復原機制。 已卸載的技能會移至資源回收筒；原生 MCP 條目使用 MCP 備份。不要用檔案系統刪除來代替 CLI 卸載。
- 將憑證排除在 MCP 定義之外。 使用
{fromEnv: VARIABLE}參考。 管理設定不需要解析秘密、複製 OAuth 憑證、啟動伺服器或探查它們的工具。 - 尊重操作範圍。 本機設定工作不代表有權限進行提交、推送或發佈。僅在使用者請求中包含這些命令時才執行它們。
常見工作流程
檢查與診斷
skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json
doctor 在發現錯誤時會以狀態碼 1 退出。稽核使用 --format json；JSON 標誌和
TUI 可用性因命令而異。請參閱相關參考資料，不要假設功能對等。
追蹤上游儲存庫或安裝選定的技能
在安裝之前選擇資源和範圍。對使用者廣泛的資源使用 -g，或對這個專案使用 -p；在預覽、套用、更新和同步時保持該範圍。
| 意圖 | 命令 |
|---|---|
| 將上游技能集合保留為一個 Git 檢出 | skillshare install owner/repo --track --name team -g |
| 僅安裝帶有來源中繼資料的具名技能 | skillshare install owner/repo -s pdf,commit -g |
| 個別安裝所有發現的技能 | skillshare install owner/repo --all -g |
| 管理一個完整的原生外掛程式，包括鉤子/MCP | 使用 plugin discover 和 plugin add；見下文 |
有關範圍化預覽 → 套用 → 更新 → 同步工作流程，請閱讀 install.md。它涵蓋了 追蹤最新的上游分支、被拒絕的旗標組合以及目標過濾器。
對於專案設定，使用 init -p，然後使用 install -p 和 sync -p。使用 install 而不指定來源來重新水合已設定的遠端依賴項。如需完整的旗標詳細資訊和代理，請閱讀 install.md 和 sync.md。
若要就地使用本機技能檢出，請執行 skillshare link <path> --enable，然後
sync；skillshare unlink <name> 僅移除連結。請閱讀
TROUBLESHOOTING.md 以了解如何追蹤此類連結。
停用或移除
skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync
執行請求的操作，而不是這個完整的範例序列。引用 glob 模式，以便 Skillshare 原樣接收。停用使用忽略規則；卸載使用資源回收筒。
將技能移動到資料夾中
skillshare move my-skill frontend --dry-run
skillshare move my-skill other-skill frontend
skillshare sync
對已安裝的技能使用 move 而不是 mv：它會保留其安裝記錄，因此
無需再次下載。它不會同步；之後再執行 sync。請閱讀
install.md 以了解拒絕情形和專案模式。
來自全域設定的專案資料夾
skillshare project list --json
skillshare project localize ~/work/existing --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --dry-run
skillshare project add ~/work/app --target claude,codex --skills-mode copy --sync
skillshare project edit app --skills-include 'frontend-*'
skillshare project sync app --json
skillshare project remove app --dry-run --json
project 始終使用全域設定，即使在儲存庫內也是如此；它不接受 -p。新專案會儲存在 config.yaml 中，或使用 --machine-local 或 projects_storage: machine-local（--shared 會覆寫該設定）僅儲存在此機器上；localize 和 share 會在兩者之間移動一個專案。移除 config.yaml 專案的本機副本會保留 config.yaml 的版本，除非給定了 --shared。編輯過濾器會取代列表。移除會分離技能並保留代理檔案；除非正在預覽，否則 JSON 移除需要 --yes。請閱讀 targets.md 以了解儲存後同步失敗、重試和部分移除結果。
MCP 設定
skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp
--target 是單數且可重複的。預覽不會套用變更。如需修訂、編輯、匯入衝突、憑證、備份和人工操作的 TUI 命令，請閱讀 mcp.md。
完整的外掛程式
對一個完整的原生套件使用 plugin discover 和 plugin add；plugin import 採用現有的原生安裝。僅執行請求的操作。請閱讀 plugins.md 後再套用變更；它涵蓋了範圍化的上游工作流程、支援的目標以及來源參考規則。plugin check/update 處理上游變更；sync plugins 協調目標選取。外掛程式被排除在 sync --all 之外。
技能中樞
skillshare hub add https://example.com/hub.json # 儲存中樞來源
skillshare hub add https://example.com/hub.json --label my-hub # 使用自訂標籤
skillshare hub add [email protected]:team/skills.git --label ghe # SSH/私人/GHE 中樞來源
skillshare hub list # 列出已儲存的中樞
skillshare hub default my-hub # 設定預設中樞
skillshare hub remove my-hub # 移除中樞
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit # 建置中樞索引
作用中的 follow_source_links 設定也適用於 hub index（包括 --source）、內建儀表板搜尋和中樞草稿候選項。
參考資料
閱讀對應檔案以取得命令旗標、範例和限制。避免為單一任務載入所有參考資料。
| 主題 | 檔案 |
|---|---|
| 原生代理、選取、忽略規則和復原 | native-agents.md |
| MCP 設定、匯入、TUI 和復原 | mcp.md |
| 原生鉤子、程式碼繫結、範圍和復原 | hooks.md |
| 完整外掛程式、原生生命週期和同步選取 | plugins.md |
| Init 旗標 | init.md |
| 同步/收集/提交/推送/拉取 | sync.md |
| 安裝/更新/卸載/移動/新增 | install.md |
| 狀態/差異/列表/搜尋/檢查 | status.md |
| 安全性稽核 | audit.md |
| 安裝前審查不可信的技能 | audit-review.md |
| 資源回收筒 | trash.md |
| 操作日誌 | log.md |
| 目標 | targets.md |
| 擴充功能（規則/命令/提示） | extras.md |
| 工作階段回顧和對已儲存筆記進行 Dreaming | memory-review.md |
| 備份/還原 | backup.md |
| 故障排除 | TROUBLESHOOTING.md |