localskills.sh

1) 創建帳戶並（可選）創建團隊: 前往 https://localskills.sh 並註冊（例如，「使用 Google 登入」）。如果您想使用基於角色的訪問控制發布/管理技能，請從儀表板創建一個團隊（團隊擁有技能；創建者成為所有者）。

2) 安裝 localskills CLI: 使用 npm 全局安裝：`npm i -g @localskills/cli`，然後驗證：`localskills --version`。

3) 登入（互動式 CLI 身份驗證）: 運行 `localskills login` 以將 CLI 驗證到您的 localskills.sh 帳戶，以便您可以發布私人/團隊技能並管理它們。

4) 了解您可以發布的內容（技能與規則）: 「技能」提供可重複使用的代理指令/工作流程，安裝到您工具的技能/規則位置。「規則」是治理/編碼標準（某些工具將這些儲存在單獨的規則目錄中）。內容是 Markdown（最大 512 KB）。每次發布都會創建一個自動遞增的版本；內容經過 SHA-256 雜湊處理，以便可以檢測更新。

5) 在本地創建您的技能內容: 將您的指令寫成 Markdown（如果使用平台的捆綁包裝，可以選擇將其組織為文件夾包）。保持描述簡潔明了（2-4 句話），以便正確的情況觸發技能。

6) 將技能發布到 localskills.sh: 從您的技能目錄（或指向文件），使用 CLI 發布：`localskills publish`（如果您的工作流程提示/要求，請包含一個名稱，例如 `your-team/skill-name`）。每次發布都會產生一個新的不可變版本，可在儀表板的版本歷史記錄中查看。

7) 匿名分享技能（無需帳戶）: 使用 `localskills share ./my-skill.md` 分享特定文件，或運行 `localskills share` 進行互動式掃描和選擇流程。首次使用時，CLI 會在 `~/.localskills/config.json` 中生成一個 Ed25519 密鑰對作為您的匿名身份。匿名用戶僅限於分享 10 個技能。

8) 將已發布的技能安裝到一個或多個工具中: 使用一個命令將 slug/名稱安裝到支援的工具中（Cursor、Claude Code、Windsurf、Cline、GitHub Copilot、Codex CLI、OpenCode、Aider），例如：`localskills install your-team/api-conventions --target cursor claude windsurf`。CLI 會寫入每個工具的原生格式/位置（例如，Claude Code 的 `.claude/skills/`，Cursor 的 `.cursor/rules/`，Windsurf 的 `.windsurf/rules/`）。

9) 選擇安裝模式（符號連結、複製或區段）: 符號連結：從工具的目標位置創建一個符號連結到 `~/.localskills/cache/` 中的緩存文件，因此更新會透過緩存自動反映。複製：將獨立副本寫入目標位置；`localskills pull` 在更新時重新寫入。區段：使用標記（例如 `<!-- localskills:start:{slug} --> ... <!-- localskills:end:{slug} -->`）將技能內容嵌入到共享文件中（適用於依賴單個共享文件的工具）。

10) 發布新版本時拉取更新: 在儲存庫中運行 `localskills pull` 以將已安裝的技能更新到最新的兼容版本。對於符號連結安裝，拉取會更新緩存，並且所有符號連結都會自動指向最新的內容。

11) 測試您的工具是否實際應用了技能: 在您的 AI 工具中啟動一個新的會話（某些工具會在啟動時掃描技能，因此正在運行的會話可能看不到新安裝的技能）。使用實際請求進行測試，而無需明確命名技能，以確認觸發和行為。

12) 從 CLI 和儀表板管理技能（列出/查看/刪除/更新）: 使用 CLI 管理註冊表內容（列出技能、查看詳細信息、刪除/移除技能以及管理版本）。使用儀表板檢查版本歷史記錄並在需要時恢復到以前的版本。

13) 使用 OIDC 進行 CI/CD 發布（無長期秘密）: 對於自動發布，請在 localskills.sh 上配置 OIDC 信任策略，並使用短期身份令牌從 CI 發布。GitHub Actions 流程示例：設置 `permissions: id-token: write`，安裝 CLI，然後運行 `localskills publish --oidc`，並將 `LOCALSKILLS_TEAM` 設置為您的團隊 slug。確保 OIDC `aud` 聲明與 `https://localskills.sh` 匹配。

14) 企業推廣（可選）：SSO、SCIM 和審計日誌: 對於組織，啟用 SAML 2.0 SSO（Okta、Microsoft Entra ID/Azure AD 等）以及可選的 SCIM 2.0 用於用戶/組供應。使用角色/權限進行團隊訪問控制，並依賴審計日誌（90 天保留）來跟踪平台操作。

15) 排除身份驗證和本地配置故障: 如果您需要重置 CLI 身份驗證，請從本地配置中清除儲存的身份驗證令牌（CLI 為此提供了命令）。匿名身份密鑰位於 `~/.localskills/config.json` 中。