Help Center

How to Use TokRepo

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

1 Getting Started

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.

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.

Share Your Work

Install the TokRepo CLI, authenticate with your API token, 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/

2 CLI Reference

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

tokrepo login— Authenticate with your API token
tokrepo login
tokrepo whoami— Show current logged-in user
tokrepo whoami
tokrepo push <dir>— Push a single asset directory
tokrepo push ./my-skill/ --private
tokrepo sync <dir>— Scan and sync all assets in a directory
tokrepo sync ~/.claude/skills/
tokrepo status <dir>— Preview sync status without pushing
tokrepo status ~/.claude/skills/
tokrepo list— List 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-...

3 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 Token?
Sign in to TokRepo, then visit the Submit page (/workflows/submit). Your API Token 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. You can also set visibility when using tokrepo sync with the --private flag.
What does tokrepo sync do exactly?
sync scans a directory tree, identifies each subdirectory as an asset, computes content hashes, compares them against your remote TokRepo assets, and pushes any new or modified ones. Unchanged assets are skipped. It's idempotent — safe to run repeatedly.
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.

4 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/upsert

Create or update an asset (idempotent)

POST
/api/v1/tokenboard/push/diff

Compare local assets against remote state

POST
/api/v1/tokenboard/push/create

Create a new asset (always creates)

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/upsert \
  -H "Authorization: Bearer tk_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Code Review Skill",
    "description": "Automated code review workflow",
    "files": [
      { "name": "SKILL.md", "content": "# Code Review\n..." },
      { "name": "review.md", "content": "## Steps\n..." }
    ],
    "tags": ["code-review", "skill"]
  }'

5 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