mirror of https://github.com/iflytek/skillhub.git synced 2026-08-28 11:25:00 +00:00

History

dongmucat 92dd64f36e docs(cli): refine registry usage examples		2026-05-06 17:32:13 +08:00
..
src	fix(cli): resolve Windows CI test failures across three platform issues	2026-04-29 16:03:09 +08:00
test	fix(cli): use fileURLToPath for cross-platform cwd path compatibility	2026-04-29 16:13:50 +08: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	chore(cli): bump version to 0.1.1	2026-05-06 17:11:46 +08:00
README.md	docs(cli): refine registry usage examples	2026-05-06 17:32:13 +08:00
tsconfig.json	feat(cli): add SkillHub CLI v1 with full command suite	2026-04-29 15:37:04 +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 for a single command flow
skillhub login --registry https://skillhub.yourcompany.com

# Search and install from the custom registry
skillhub search react --registry https://skillhub.yourcompany.com
skillhub install @yourorg/custom-skill --registry https://skillhub.yourcompany.com

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

export 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

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

# Search and install from your private registry
skillhub search internal-tools --registry https://skillhub.yourcompany.com
skillhub install @yourorg/internal-skill --registry https://skillhub.yourcompany.com

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 in either of these ways:

# Per-command override
skillhub login --registry https://skillhub.yourcompany.com
skillhub search react --registry https://skillhub.yourcompany.com

# Shell-level default
export SKILLHUB_REGISTRY=https://skillhub.yourcompany.com

Use --registry when you want to target a specific registry for one command without changing your shell environment.

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