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 会生成一个 Ed25519 密钥对，存储在 `~/.localskills/config.json` 中作为您的匿名身份。匿名用户最多可共享 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` 中。