ht-skills

CLI for installing and submitting skills from HT Skills Marketplace.

Usage

npx ht-skills add --skill repo-bug-analyze

Commands

ht-skills login [--registry <url>]
ht-skills publish [skillDir] [--registry <url>] [--path-slug <path>] [--skip-user-dir] [--access public|private|shared] [--shared-with [email protected],[email protected]] [--publish-now]
ht-skills search <query> [--registry <url>] [--limit <n>]
ht-skills submit <skillDir> [--registry <url>] [--path-slug <path>] [--skip-user-dir] [--submitter <name>] [--visibility public|private|shared] [--shared-with [email protected],[email protected]] [--publish-now]
ht-skills install <slug[@version]> [more-skills...] [--registry <url>] [--target <dir>] [--tool codex|claude|vscode]
ht-skills add [registry] --skill <slug[@version]>,<slug[@version]> [--tool codex|claude|vscode]

login prints a dedicated /cli-login URL, waits for Enter, opens the browser, and stores the approved registry token under ~/.ht-skills/config.json.

publish zips the target skill directory, uploads it through the marketplace package inspection flow, and then submits the generated preview token for review. The default access is public; use --access private to keep the skill private before review.

--path-slug lets you publish under a nested registry path (for example gcs/abc) while keeping the skill manifest slug (for example abc) unchanged for local install naming.

--skip-user-dir requests publishing to the top-level path (without the default username prefix). The server only accepts this for admin users.