ClawhHub Skill Publisher#

You help users publish (or update) a skill on ClawhHub using the clawhub publish CLI.

Workflow (follow in order)#

Step 1 — Identify the skill folder#

Check if the user already specified a path or skill name. If not, list available skills:

bash

ls ~/.claude/skills/

If there's only one skill, use it directly. If there are multiple, ask the user which one to publish.

The skill folder path is typically ~/.claude/skills/<slug>/.

Step 2 — Read the skill's metadata#

Read SKILL.md from the skill folder to extract:

• name field from frontmatter → use as --name
• The slug is the folder name (unless the user says otherwise)

Also check if there's a version field in the frontmatter (some skills track it there).

Step 3 — Check current published version#

Run:

bash

clawhub inspect <slug> 2>&1

Look for the Latest: line (e.g. Latest: 1.0.2). If the skill has never been published, start at 1.0.0.

If clawhub inspect returns an error like "not found", treat current version as 0.0.0 and suggest 1.0.0 as the first release.

Step 4 — Suggest a version bump#

Show the user the current version and suggest the next patch version by default (most releases are patches). Also offer minor and major:

text

当前版本：1.0.2
建议版本：
  1. 1.0.3（patch — 修复bug、优化提示词）← 推荐
  2. 1.1.0（minor — 新增功能或较大改动）
  3. 2.0.0（major — 破坏性变更或完全重写）

请选择版本号，或直接输入自定义版本：

Wait for the user to confirm or specify a version.

Step 5 — Get changelog#

Ask what changed in this version:

text

这次版本更新了什么？（将作为 changelog 写入发布记录）

Keep it brief — one sentence is fine. If the user says "skip" or similar, use a generic message like "Minor updates".

Step 6 — Confirm and publish#

Show a summary before running:

text

📦 即将发布：
  Skill：<folder-path>
  Slug：<slug>
  名称：<name>
  版本：<version>
  Changelog：<changelog>
  Tags：latest

确认发布吗？

After confirmation, run:

bash

clawhub publish <folder-path> \
  --slug <slug> \
  --name "<name>" \
  --version <version> \
  --changelog "<changelog>" \
  --tags latest

Step 7 — Report result#

On success, the output contains: ✔ OK. Published <slug>@<version> (<id>)

Report back clearly:

text

✅ 发布成功！
  <slug>@<version>
  ID：<id>

If it fails, show the error message and suggest common fixes:

• Version already exists → bump the version
• Not logged in → run clawhub login
• Slug mismatch → verify the slug matches what was previously published

Optional: Update version in SKILL.md#

After a successful publish, offer to update the version field in SKILL.md frontmatter (so future publishes can auto-detect it):

text

是否将版本号 <version> 写入 SKILL.md frontmatter？（方便下次自动识别当前版本）

If the user agrees, add or update version: <version> in the YAML frontmatter of SKILL.md.

Key CLI reference#

text

clawhub publish <path>
  --slug <slug>        # Unique skill identifier (required)
  --name <name>        # Display name shown on clawhub.com
  --version <version>  # Semver (required, must be higher than current)
  --changelog <text>   # Release notes for this version
  --tags <tags>        # Comma-separated, default "latest"

clawhub whoami         # Show logged-in user
clawhub inspect <slug> # Show published skill info including latest version
clawhub sync           # Auto-scan and publish all local skills with changes