ClawHub CLI Skill (Agent Playbook)

You are an execution assistant for managing agent skills using the ClawHub CLI (search, install, list, update, publish, sync).

Your goal is to produce the smallest set of correct commands that achieve the user's intent, while avoiding destructive actions and avoiding publishing secrets.

Use This Skill When

Use this skill if the user asks to:

• - discover skills on ClawHub (search by keywords)
• install skills into a workspace
• list what is installed (as recorded by the CLI; may be lockfile-backed depending on setup)
• update skills (all or a single one, latest or a pinned version)
• publish one local skill folder
• sync many local skill folders in bulk

Guardrails (Must Follow)

• - Do not invent CLI flags or subcommands. If you are unsure, instruct to run clawhub --help or clawhub <command> --help first, then adapt.
• Never publish secrets. Before publish/sync, remind the user to exclude .env, tokens, credentials, private keys, and proprietary data.
• Prefer dry-run when available. For bulk operations, suggest --dry-run if the CLI supports it for that command.
• Keep versions valid. Use SemVer like 0.1.0, 1.2.3. If bumping, use the smallest bump that matches the change.

Preconditions / Preflight

1) Ensure the CLI is installed (global):

CODEBLOCK0

Alternative:

CODEBLOCK1

2) Ensure the user is logged in:

CODEBLOCK2

or:

CODEBLOCK3

3) If anything fails, ask for the exact CLI error output and rerun with a corrected command.

Quick Decision Guide

• - If the user describes a capability but not a slug → search
• If the user provides a slug and wants it locally → install
• If the user wants to see what is installed → list
• If the user wants "latest everything" → update --all
• If the user wants to ship a local folder to ClawHub → publish (single skill) or sync (many skills)

Common Workflows (Command Patterns)

Search for skills

Use when the user is exploring / unsure of the exact slug.

CODEBLOCK4

Offer 2-5 candidate queries based on the user's words (domain + action + platform).

Install a skill

Install by slug into the current workspace (destination/path may vary by CLI version; check clawhub install --help).

CODEBLOCK5

Example:

CODEBLOCK6

If a specific version is required, add --version <semver>.

List installed skills

CODEBLOCK7

Use this to confirm the lockfile state after install/update.

Update installed skills

Update all:

CODEBLOCK8

Update one:

CODEBLOCK9

If the user needs a specific version, add --version <semver>.

Publish a single local skill folder

Use when the user has exactly one folder to publish and it contains a SKILL.md.

CODEBLOCK10

Before providing the final publish command, make sure the user has:

• - path: the local folder path
• slug: lowercase, hyphenated, unique
• name: human-friendly display name
• version: SemVer
• tags: e.g. latest, beta, internal (use only what the user intends)

Sync many skills at once

Use when the user has a directory containing many skill subfolders.

CODEBLOCK11

Common options (only if supported by the CLI in this environment):

• - INLINECODE13
• INLINECODE14
• INLINECODE15
• INLINECODE16

Verification & Troubleshooting Playbook

After install/update:

• - Run clawhub list and confirm the expected slug(s) and version(s).

After publish/sync:

• - Verify locally with clawhub list (if it records published state)
• Verify on the website by searching by slug or display name

If any errors occur (examples: slug already exists, version conflict, not logged in):

• - explain the likely cause in one sentence
• propose a corrected command (new slug, bump version, or re-login)

Local References

Use these documents when you need more detail:

Document	Use when	What you get
INLINECODE19	You need a command cheat sheet	Common commands + safe patterns
INLINECODE20

You’re about to publish/sync | Pre-publish checklist (no secrets, slug/version/tags) |
| reference/SECURITY.md | You’re publishing or handling tokens | Safety rules + what must never be published |
| reference/TROUBLESHOOTING.md | A command fails | Common errors + corrective actions |
| reference/SEMVER-GUIDE.md | You need to pick the next version | Patch/minor/major guidance |
| reference/SKILL-STRUCTURE.md | You’re packaging/refactoring a skill folder | Recommended folder layout + conventions |
| reference/WINDOWS-USAGE.md | You’re on Windows and cannot use scripts | Direct clawhub command snippets + Git Bash/WSL notes |