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:

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

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:

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:

当前版本：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:

这次版本更新了什么？（将作为 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:

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

确认发布吗？

After confirmation, run:

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 @ ()

Report back clearly:

✅ 发布成功！
  <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):

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

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

Key CLI reference

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