peiiii / skillhub-guide

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

• Tencent Skillhub install doc:
  https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md

• Quick readiness check script in this skill:
  bash skills/skillhub-guide/scripts/check-skillhub.sh

• Windows PowerShell readiness check in this skill:
  powershell -ExecutionPolicy Bypass -File skills/skillhub-guide/scripts/check-skillhub.ps1