Help Center

How to Use TokRepo

From browsing assets to CLI sync — everything you need to get started.

01

Getting Started

  1. 1

    Browse & Discover

    Explore the homepage for trending assets, use search to find specific skills, or browse by collection to discover curated content from official accounts.

  2. 2

    Install with One Click

    Every asset page includes a ready-to-use install command. Click "Use This Asset", copy the command, and paste it into your AI tool. No account required to browse or install.

  3. 3

    Share Your Work

    Install the TokRepo CLI, authenticate with your API key, and push your local skills or prompts in one command. Your assets get a permanent URL, version tracking, and community visibility.

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

CLI Reference

The TokRepo CLI lets you manage AI assets from your terminal. Install globally to get started:

tokrepo loginAuthenticate with your API key
$ tokrepo login
tokrepo whoamiShow current logged-in user
$ tokrepo whoami
tokrepo push <dir>Push a single asset directory
$ tokrepo push ./my-skill/ --private
tokrepo status <dir>Preview sync status without pushing
$ tokrepo status ~/.claude/skills/
tokrepo listList your published assets
$ tokrepo list
tokrepo search <query>Search community assets
$ tokrepo search "code review"
tokrepo install <uuid>Install an asset locally
$ tokrepo install a1b2c3d4-e5f6-...
03

FAQ

Is TokRepo free to use?
Yes. TokRepo is completely free — browse, install, fork, and publish assets at no cost. There are no premium tiers or paywalls.
Which AI coding tools are supported?
TokRepo assets work with Claude Code, Cursor, GitHub Copilot, Gemini CLI, OpenAI Codex, Windsurf, and VS Code. Skills follow the agentskills.io cross-platform standard for maximum compatibility.
How do I get my API Key?
Sign in to TokRepo, then visit the Submit page (/workflows/submit). Your API Key is displayed automatically after login. Copy it and use it with tokrepo login in the CLI.
Can I make my assets private?
Yes. Add --private when pushing: tokrepo push ./my-skill/ --private. Private assets are only visible to you. Re-running push with the same flag preserves the private state.
How does forking work?
Click "Fork" on any asset page to create your own copy. The forked asset appears in your profile with full edit access. The original asset tracks fork count for community reference.
How are token costs estimated?
By default, token cost is estimated from content length (approximately 1 token per 4 characters). Authors can override this with a custom token_cost value when publishing for more accurate estimates.
Does TokRepo support version history?
Yes. Every time you update an asset via CLI push or sync, a new version is recorded. You can view the version history on the asset detail page.
04

API Reference

All APIs use https://api.tokrepo.com as base URL. Authenticated endpoints require Header: Authorization: Bearer tk_xxx.

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

Create or update an asset (OSS version)

POST
/api/v1/tokenboard/push/diff

Compare local assets against remote state

POST
/api/v1/tokenboard/push/create

Legacy: Create a new asset (DB version)

GET
/api/v1/tokenboard/workflows/list

List and search published assets

GET
/api/v1/tokenboard/workflows/detail

Get full asset detail by UUID

GET
/api/v1/tokenboard/workflows/raw

Get raw content (agent-friendly)

GET
/api/v1/tokenboard/tags/list

List available tags

Push Example
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"]
  }'

Private assets can be opened by the owner when signed in. The Push API also returns share_token and share_url, so CLI callers can open or share a working private link without an extra detail request.

Private Push Response
{
  "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

Keyboard Shortcuts

Focus search/
Next / previous assetj / k
Open selected asseto
Star / unstar assets
Go to Homeg h
Go to Trendingg e
Show all shortcuts?

Didn't find your answer?

Reach out anytime — we typically respond within 24 hours.

ethanfrostcool@gmail.com
◈Home🔍Search👤Me