scriptoriumadmin/skillhub
1
0
Fork 0
mirror of https://github.com/iflytek/skillhub.git synced 2026-08-28 11:25:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
skillhub/cli
History
Exact
huishi3 5206ffa4e0 docs(cli): add e2e test placement decision tree and output conventions 
Three docs that answer "where should my new test go?" for CLI-related e2e:

- cli/test/e2e/README.md: decision tree across 5 test tracks, Track B
  boundary, env var setup (SKILLHUB_E2E_*), new-test checklist, CI status
- web/e2e/auto-generated/README.md: marks directory as pipeline output,
  naming convention, boundary with hand-written specs
- e2e-automation/README.md: output location convention, module subdirectory
  layout, boundary clarification (pipeline only produces browser-subject specs)
2026-05-08 03:54:24 -07:00
..
scripts test(cli): add comprehensive integration tests and fix update command bugs 2026-05-07 14:46:40 +08:00
src refactor(cli): improve doctor command semantics and transparency 2026-05-09 11:30:36 +08:00
test docs(cli): add e2e test placement decision tree and output conventions 2026-05-08 03:54:24 -07:00
.env.example feat(cli): add npm publish workflow and update package scope 2026-05-06 16:34:59 +08:00
.eslintrc.cjs feat(cli): add SkillHub CLI v1 with full command suite 2026-04-29 15:37:04 +08:00
bun.lock feat(cli): add SkillHub CLI v1 with full command suite 2026-04-29 15:37:04 +08:00
bunfig.toml feat(cli): add SkillHub CLI v1 with full command suite 2026-04-29 15:37:04 +08:00
LICENSE feat(cli): add npm publish workflow and update package scope 2026-05-06 16:34:59 +08:00
package.json test(cli): add comprehensive integration tests and fix update command bugs 2026-05-07 14:46:40 +08:00
README.md refactor(cli): improve doctor command semantics and transparency 2026-05-09 11:30:36 +08:00
tsconfig.json test(cli): add comprehensive integration tests and fix update command bugs 2026-05-07 14:46:40 +08:00

README.md

SkillHub CLI

Manage and install skills for AI coding agents.

SkillHub is an enterprise-grade, self-hosted skill registry that enables teams to discover, share, and install reusable skills for AI coding agents like Claude Code. This CLI provides a seamless interface to interact with SkillHub registries.

📦 Installation

npm install -g @astron-team/skillhub

🚀 Quick Start

Using the default registry

# Login to the default registry
skillhub login

# Search for skills
skillhub search react

# Install a skill
skillhub install @astron-team/react-component-builder

# List installed skills
skillhub list

Using a custom registry

# Login to a custom registry
skillhub login --registry https://skillhub.yourcompany.com

# After login, other commands will use the same registry
skillhub search react
skillhub install @yourorg/custom-skill

You can also set a default custom registry in your shell:

🐧 Linux/macOS (Bash/Zsh):

export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com

🪟 Windows (PowerShell):

$env:SKILLHUB_REGISTRY="https://skillhub.yourcompany.com"

🪟 Windows (CMD):

set SKILLHUB_REGISTRY=https://skillhub.yourcompany.com

📚 Commands

🔐 Authentication

  • skillhub login [--registry <url>] - Authenticate with a SkillHub registry
  • skillhub logout [--registry <url>] - Remove stored credentials

🎯 Skill Management

  • skillhub search <query> - Search for skills in the registry
  • skillhub install <skill-name> - Install a skill to ~/.claude/skills/
  • skillhub uninstall <skill-name> - Remove an installed skill
  • skillhub list - List all installed skills
  • skillhub info <skill-name> - Show detailed information about a skill

🛠️ Utilities

  • skillhub version - Display CLI version
  • skillhub help - Show help information
  • skillhub doctor [--json] - Scan the current project for installed skills and merge findings into the local inventory. Existing entries outside the scan are preserved; conflicts are reported but unrelated records are not deleted.

💡 Examples

Search and install a skill

# Search for React-related skills
skillhub search react

# Install a specific skill
skillhub install @astron-team/react-component-builder

# Verify installation
skillhub list

Manage installed skills

# View details about an installed skill
skillhub info @astron-team/react-component-builder

# Uninstall a skill
skillhub uninstall @astron-team/react-component-builder

Work with custom registries

# Login to your private registry
skillhub login --registry https://skillhub.yourcompany.com

# After login, search and install work automatically
skillhub search internal-tools
skillhub install @yourorg/internal-skill

🌐 Registry

Default registry

By default, the CLI connects to the public SkillHub registry at https://skill.xfyun.cn.

Custom registry

Organizations can deploy their own private SkillHub instance. You can point the CLI to a custom registry:

Per-command (recommended for one-time use):

skillhub login --registry https://skillhub.yourcompany.com

Shell-level default (persistent across commands):

🐧 Linux/macOS:

export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com

🪟 Windows PowerShell:

$env:SKILLHUB_REGISTRY="https://skillhub.yourcompany.com"

🪟 Windows CMD:

set SKILLHUB_REGISTRY=https://skillhub.yourcompany.com

Skill namespaces

Skills are namespaced by organization to prevent naming conflicts:

  • @astron-team/skill-name - Skills from the Astron team
  • @yourorg/skill-name - Skills from your organization

When installing skills, always include the full namespaced name.

📄 License

Apache-2.0

Copyright 2026 iFlytek Co., Ltd.