tr-skills

tr-skills is a small CLI for installing remote skills from an iFlytek SkillHub registry into local AI tool skill directories.

Features

• Save registry credentials with login
• Search skills with search
• Install a skill ZIP package with install
• List installed skills in Cursor, Trae, Trae-CN, Claude, Codex, and CodeBuddy with list
• Work with SkillHub global skills like java-reviewer
• Work with SkillHub namespace skills like @my-team/java-reviewer
• Bare skill names install from the global namespace only

Supported targets

• cursor -> ~/.cursor/skills
• trae -> ~/.trae/skills
• trae-cn -> ~/.trae-cn/skills
• claude -> ~/.claude/skills
• codex -> ~/.codex/skills
• codebuddy -> ~/.codebuddy/skills

Quick Start

Install directly from GitHub using npm:

npm install kulumaa/tr-skills

Or use it directly with npx (no installation required):

npx tr-skills login --token sk_xxx --registry http://your-skillhub.com
npx tr-skills search java
npx tr-skills install java-reviewer --target cursor
npx tr-skills install java-reviewer --target codex
npx tr-skills install java-reviewer --target trae-cn
npx tr-skills install @my-team/java-reviewer --target claude
npx tr-skills install java-reviewer --target codebuddy
npx tr-skills install mobile-android
npx tr-skills list
npx tr-skills list --target codex
npx tr-skills list --target claude

Local Development Setup

git clone https://github.com/kulumaa/tr-skills.git
cd tr-skills
npm install
npm link

Then you can run:

tr-skills login --token sk_xxx --registry http://your-skillhub.com
tr-skills search java
tr-skills install java-reviewer --target cursor
tr-skills list

SkillHub API compatibility

This project is now aligned to iFlytek SkillHub's documented APIs and compatibility layer.

It will try these endpoints:

• GET /api/v1/whoami
• GET /api/v1/search?q=<keyword>&limit=<n>
• GET /api/v1/skills/{namespace}/{slug}/resolve?version=latest

If the server exposes the OpenClaw-compatible compat layer, it can also fall back to:

• GET /api/v1/resolve?slug=<compat-slug>&version=latest
• GET /api/cli/v1/auth/whoami
• GET /api/cli/v1/skills/search?q=<keyword>&limit=<n>

SkillHub namespace examples:

• Global namespace skill: java-reviewer
• Team namespace skill: @my-team/java-reviewer
• Bare names such as java-reviewer always mean global/java-reviewer

Notes

• Installed skills are extracted into a dedicated folder named after the SkillHub compat slug.
• Reinstalling the same skill replaces the existing target folder.
• login validates the token against the server before saving local config.
• Future enhancements can include version pinning, update, uninstall, and publish.