| name | skillhub-guide |
| description | Use when the user wants to discover, install, or use Tencent Skillhub from NextClaw, especially for CLI-only install, readiness checks, and safe skill installation guidance. |
Skillhub Guide
Overview
Use this skill when the user wants to work with Tencent Skillhub from inside NextClaw.
This skill is intentionally explicit about boundaries:
- This marketplace skill owns explanation, onboarding, readiness checks, and troubleshooting guidance.
- The upstream
skillhub CLI owns actual search and install behavior.
- NextClaw marketplace and Tencent Skillhub are different ecosystems and should not be described as the same thing.
From the user's point of view, the flow should feel complete:
- understand what Skillhub is,
- install the CLI with the least surprising path,
- verify that the CLI is actually ready,
- discover available Skillhub skills,
- then install a specific Skillhub skill into the intended workspace.
Do not pretend Skillhub is ready when it is not.
Platform Notes
NextClaw itself is cross-platform, so this skill must not assume the user is on macOS or Linux.
Current upstream Skillhub installation guidance is shell-based and routes through a bash installer.
That means:
- on macOS and Linux, the documented command can be used directly;
- on Windows, do not present the
bash installer as a native PowerShell command;
- if the user is on Windows, explain that they currently need a Bash-compatible environment such as Git Bash or WSL unless Tencent publishes a native Windows installer.
Use platform-appropriate readiness checks:
Get-Command skillhub
skillhub --help
where skillhub
skillhub --help
command -v skillhub
skillhub --help
What Skillhub Is
Skillhub is a Tencent-provided skill distribution channel for AI agents.
Useful mental model:
- NextClaw marketplace: installs NextClaw marketplace skills.
- Skillhub: installs Tencent Skillhub skills through the local
skillhub CLI.
- This skill: helps the AI guide the user through Skillhub setup and usage inside NextClaw.
Default Recommendation
Default to the CLI-only install path unless the user explicitly wants the upstream full install behavior.
Why:
- CLI-only is more predictable.
- It avoids silently pulling in extra upstream skill assets.
- It lets the user search and install specific Skillhub skills intentionally.
Preferred install command:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
Optional upstream full install:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
Use the full install path only when the user explicitly wants Skillhub's upstream default integration behavior.
First-Use Workflow
When the user asks to use Skillhub, follow this order.
1. Classify the goal
Classify the request into one of these:
- learn what Skillhub is,
- install the Skillhub CLI,
- search for available Skillhub skills,
- install a specific Skillhub skill,
- troubleshoot an existing Skillhub setup.
If the user only wants to browse skills, do not jump straight into installation.
2. Check whether skillhub already exists
Run:
command -v skillhub
On Windows, use:
Get-Command skillhub
If missing, recommend the CLI-only install command by default.
After install, do not assume success until a real command works.
3. Verify readiness
Run at least one of these:
skillhub --help
skillhub search test
Interpretation:
--help succeeds: the CLI is installed and callable.search returns normal output or a normal empty result: the CLI can reach its search flow.- command not found, permission failure, or shell parse failure: setup is not ready yet.
4. Prefer direct CLI verification over host-agent assumptions
Inside NextClaw, keep behavior explicit:
- if the user wants guaranteed usage right now, prefer direct CLI commands first;
- do not promise implicit host-agent discovery unless it has been directly observed.
Treat skillhub CLI readiness as the source of truth instead of inventing a restart step.
5. Discover available skills
Use:
skillhub search <keyword>
Examples:
skillhub search code-review
skillhub search seo
skillhub search feishu
If the user does not know the exact skill name, search first and present the likely matches before offering installation.
6. Install a specific Skillhub skill
Use:
skillhub install <skill-name>
Tencent's install doc says the skill is installed into the current workspace.
Because this is a write action, confirm the intended workspace first if there is any ambiguity.
Do not install into an accidental directory.
7. Verify post-install result
After installation, ask the user to test one real task that should invoke the newly installed Skillhub skill.
Success means:
skillhub commands run successfully,- the target skill installs without error,
- the user can invoke the resulting capability in the intended workspace or host agent flow.
Safe Execution Rules
- Prefer CLI-only install unless the user asks for upstream full install.
- On Windows, explicitly say that the current upstream installer is Bash-based.
- Search before install when the exact skill name is uncertain.
- Treat
skillhub install <skill-name> as a write action to the current workspace.
- If the current workspace is unclear, stop and clarify the target directory before installing.
- Do not describe Skillhub as built into NextClaw.
- Do not claim automatic agent-side detection unless the user has directly observed it.
Troubleshooting
skillhub command not found
- The CLI is not installed or not on
PATH.
- Re-run the CLI-only install command.
- On Windows, confirm the user is running it from Git Bash or WSL if they are following the current upstream installer.
- Open a new shell if the current shell has not picked up the updated
PATH yet.
skillhub --help works but agent does not seem to notice Skillhub
- Do not invent a host-app restart requirement.
- Use direct CLI commands in the meantime instead of waiting on implicit discovery.
Search or install fails
- Check network connectivity.
- Retry the same command once.
- If it still fails, keep the failure visible instead of pretending the skill was installed.
User is unsure what to install
- Start with
skillhub search <keyword>.
- Present the likely matches and ask which one they want.
Success Criteria
This skill is working correctly when:
- the user understands what Skillhub is and is not,
- the user receives the CLI-only install path by default,
- readiness is verified with an observable command,
- skill discovery happens through
skillhub search,
- installation happens intentionally through
skillhub install,
- and ambiguous workspace writes are not performed silently.
Resources
