Manage Agent Skills Cli 3

---
name: manage-agent-skills-cli-3
description: "Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.ai. Use when you need to fetch new skills on the fly, sync installed skills to the latest or a specific version, or publish new or updated skill folders with the npm-installed ClawHub CLI."
category: "AI & Agents"
author: community
version: "1.0.2"
icon: bot
---

# 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):

```bash
npm i -g clawhub
```

Alternative:

```bash
pnpm add -g clawhub
```

2) Ensure the user is logged in:

```bash
clawhub login
```

or:

```bash
clawhub login --token <api-token>
```

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.

```bash
clawhub search "your query"
```

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`).

```bash
clawhub install <skill-slug>
```

Example:

```bash
clawhub install postgres-backup-tools
```

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

### List installed skills

```bash
clawhub list
```

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

### Update installed skills

Update all:

```bash
clawhub update --all
```

Update one:

```bash
clawhub update <skill-slug>
```

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`.

```bash
clawhub publish ./skills/my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 0.1.0 \
  --tags latest
```

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.

```bash
clawhub sync --all
```

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

- `--tags latest`
- `--changelog "Update skills"`
- `--bump patch|minor|major`
- `--dry-run`

## 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 |
|---|---|---|
| `reference/CLI-COMMANDS.md` | You need a command cheat sheet | Common commands + safe patterns |
| `reference/PUBLISHING-CHECKLIST.md` | 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 |