帮助中心

如何使用 TokRepo

从浏览资产到 CLI 同步,这里是你需要知道的一切。

01

快速上手

  1. 1

    浏览和发现

    通过首页浏览热门资产,用搜索查找特定 Skill,或按精选集浏览官方账号的策展内容。

  2. 2

    一键安装

    每个资产页面都有即用安装命令。点击"使用这个资产",复制命令,粘贴到你的 AI 工具中。浏览和安装无需注册。

  3. 3

    分享你的作品

    安装 TokRepo CLI,用 API Key 认证,一条命令推送你的本地 Skill 或 Prompt。你的资产将获得永久链接、版本追踪和社区曝光。

    npm install -g tokrepo
    tokrepo login
    tokrepo push ./my-skill/
02

CLI 命令参考

TokRepo CLI 让你在终端中管理 AI 资产。全局安装后即可使用:

tokrepo login使用 API Key 认证
$ tokrepo login
tokrepo whoami显示当前登录用户
$ tokrepo whoami
tokrepo push <dir>推送单个资产目录
$ tokrepo push ./my-skill/ --private
tokrepo status <dir>预览同步状态但不推送
$ tokrepo status ~/.claude/skills/
tokrepo list列出你发布的资产
$ tokrepo list
tokrepo search <query>搜索社区资产
$ tokrepo search "code review"
tokrepo install <uuid>将资产安装到本地
$ tokrepo install a1b2c3d4-e5f6-...
03

常见问题

TokRepo 是免费的吗?
是的。TokRepo 完全免费——浏览、安装、Fork 和发布资产均不收费。没有付费等级或内容墙。
支持哪些 AI 编码工具?
TokRepo 资产兼容 Claude Code、Cursor、GitHub Copilot、Gemini CLI、OpenAI Codex、Windsurf 和 VS Code。Skills 遵循 agentskills.io 跨平台标准以确保最大兼容性。
如何获取 API Key?
登录 TokRepo,访问提交页面(/workflows/submit)。登录后你的 API Key 会自动显示。复制后在 CLI 中用 tokrepo login 使用。
可以将资产设为私有吗?
可以。推送时加 --private 参数:tokrepo push ./my-skill/ --private。私有资产仅你自己可见。重新跑 push 并带同样的 --private 标志会保持私有状态。
Fork 功能如何工作?
在任意资产页面点击"Fork"即可创建你自己的副本。Fork 后的资产出现在你的个人页面,你拥有完整编辑权限。原资产会追踪 Fork 数作为社区参考。
Token 成本如何估算?
默认基于内容长度估算(约每 4 个字符 1 个 token)。作者在发布时可通过自定义 token_cost 值覆盖,以提供更准确的估算。
TokRepo 支持版本历史吗?
支持。每次通过 CLI 推送或同步更新资产时都会记录新版本。你可以在资产详情页查看版本历史。
04

API 参考

所有 API 以 https://api.tokrepo.com 为基础路径。需要认证的接口在 Header 中添加 Authorization: Bearer tk_xxx。

POST
/api/v1/tokenboard/push/oss/upsert

创建或更新资产(OSS 存储版)

POST
/api/v1/tokenboard/push/diff

对比本地资产与远端状态

POST
/api/v1/tokenboard/push/create

旧版:创建新资产(数据库直存)

GET
/api/v1/tokenboard/workflows/list

列出和搜索已发布资产

GET
/api/v1/tokenboard/workflows/detail

通过 UUID 获取完整资产详情

GET
/api/v1/tokenboard/workflows/raw

获取原始内容(Agent 友好)

GET
/api/v1/tokenboard/tags/list

获取可用标签列表

推送示例
curl -X POST https://api.tokrepo.com/api/v1/tokenboard/push/oss/upsert \
  -H "Authorization: Bearer tk_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Code Review Skill",
    "description": "Automated code review workflow",
    "visibility": 0,
    "files": [
      { "name": "SKILL.md", "content": "# Code Review\n..." },
      { "name": "review.md", "content": "## Steps\n..." }
    ],
    "tags": ["code-review", "skill"]
  }'

私有资产在登录 owner 后可直接打开。Push API 同时返回 share_token 和 share_url,CLI 调用方无需再额外请求 detail 就能拿到可用的私有访问链接。

私有推送响应
{
  "uuid": "5980ac3a-1bd6-4206-84cf-be98fe1e6a3a",
  "url": "https://tokrepo.com/en/workflows/my-code-review-skill-5980ac3a",
  "share_token": "6a82928329b411f0a884d4dc9af4b8e2",
  "share_url": "/workflows/my-code-review-skill-5980ac3a?share_token=6a82928329b411f0a884d4dc9af4b8e2",
  "action": "created",
  "version": 1
}
05

键盘快捷键

聚焦搜索/
下一个 / 上一个资产j / k
打开选中的资产o
收藏 / 取消收藏s
前往首页g h
前往热门g e
显示所有快捷键?

没找到答案?

随时联系我们,通常在 24 小时内回复。

ethanfrostcool@gmail.com