现成的(ots)
  ](https://github.com/XeldarAlz/off-the-shelf)
现成的Claude Code资产的共享注册表。直接从您的终端浏览、搜索和安装代理、技能、CLAUDE.md模板、钩子和MCP配置。
快速开始
# Install ots
curl -fsSL https://raw.githubusercontent.com/XeldarAlz/off-the-shelf/main/install.sh | bash
# Browse assets interactively
ots
# Or install directly
ots install skills/quick-commit分类
| 类别 | 路径 | 描述 |
|---|---|---|
| 代理商 | agents/ | 代理提示和配置 |
| 技能 | skills/ | 自定义斜线命令技能(.claude/commands/) |
| CLAUDE.md | claude-md/ | 项目模板文件 |
| 钩子 | hooks/ | Claude Code的钩子配置 |
| MCP配置 | mcp-configs/ | MCP服务器配置 |
命令参考
| 命令 | 描述 | 示例 |
|---|---|---|
ots / ots browse | 交互式fzf浏览器 | ots |
ots list [category] | 列出类别或项目 | ots list skills |
ots search | 搜索所有类别 | ots search "review" |
ots info | 显示项目详细信息 | ots info agents/code-reviewer |
ots install | 将项目安装到当前目录 | ots install skills/quick-commit |
ots install --dry-run | 无需写入即可预览安装 | ots install agents/reviewer --dry-run |
ots uninstall | 删除以前安装的项目 | ots uninstall skills/quick-commit |
ots config | 配置注册表设置 | ots config |
ots update | 清除缓存并刷新 | ots update |
ots self-update | 将ots更新到最新版本 | ots self-update |
ots init [dir] | 创建新的注册表仓库结构 | ots init ./my-registry |
ots help | 显示帮助 | ots help |
ots version | 显示版本 | ots version |
命令别名
| 完整 | 别名 |
|---|---|
browse | b |
list | ls, l |
search | s |
info | i |
install | in |
uninstall | rm |
config | cfg |
update | u |
self-update | selfupdate |
认证
对于私有注册表或为了避免GitHub API速率限制,请设置 GITHUB_TOKEN:
# Option 1: Export in your shell profile
export GITHUB_TOKEN="ghp_your_token_here"
# Option 2: Set per-command
GITHUB_TOKEN="ghp_..." ots browse令牌需要 repo 私有存储库的范围,或者公共存储库根本没有范围(只是增加了速率限制)。
清单架构
每个注册表项都是一个目录,其中包含 manifest.json 以及一个或多个有效载荷文件。
{
"name": "Human-readable name",
"description": "What this item does",
"author": "github-username",
"tags": ["tag1", "tag2"],
"install": {
"source-file.md": ".claude/commands/target.md"
},
"postInstall": "Optional message shown after install"
}| 字段 | 必填 | 描述 |
|---|---|---|
name | 是 | 显示名称 |
description | 是 | 简短描述 |
author | 是 | 作者的GitHub用户名 |
tags | 否 | 搜索标签数组 |
install | 是 | 地图 source -> destination 路径 |
postInstall | 否 | 安装后显示消息 |
这 install map定义了源文件(相对于项目目录)及其目标(相对于项目根目录)。在目的地前添加前缀 ~ 对于相对于的路径 $HOME.
需求
curl,jq,fzf- macOS或Linux(bash 3.2+)
- 可选:
GITHUB_TOKEN用于私人repos
