Skill Publisher#

End-to-end workflow for publishing an AgentSkill directory to ClawHub.

---

Pre-publish Checklist#

☐ 1. Content Internationalization#

• SKILL.md: use English (Agent can handle any language, but English description/tags improve search matching on ClawHub)
• Remove hardcoded local paths, usernames (e.g., /mnt/e/Users/...)
• Replace user-specific config with generic placeholders or discovery methods

☐ 2. Meta Verification#

bash

cat <skill-dir>/_meta.json

Check:

• name matches the --slug you'll publish with
• version is updated (semver)
• tags are accurate (affects ClawHub search)
• description is concise (this is what agents match against)

☐ 3. Slug Conflict Check#

bash

clawhub inspect <slug>

• Returns skill info → slug is taken
  • Yours → publish will overwrite/upgrade
  • Someone else's → rename slug, e.g. my-skill → my-skill-v2
• Errors "not found" → slug is available

☐ 4. Login#

bash

clawhub whoami

If not logged in:

bash

clawhub login

Opens a browser for authorization.

---

Publish#

Prerequisites: clawhub CLI must be installed ( npm i -g clawhub)

bash

clawhub publish ~/.openclaw/skills/<skill> \
  --slug <slug> \
  --name "Display Name" \
  --version x.y.z \
  --tags "tag1,tag2" \
  --changelog "Release notes"

Parameters#

ParamDescriptionExamplepathSkill directory~/.openclaw/skills/my-skill``--slugUnique identifiermy-skill``--nameDisplay nameMy Skill``--versionSemver version1.0.0``--tagsComma-separated search tagslogseq,notes``--changelogRelease notesInitial release

---

Post-publish Verification#

bash

# New versions may be hidden by security scan, wait ~60s
sleep 60

# Check published info
clawhub inspect <slug>

# Confirm search
clawhub search <slug>

---

Common Errors#

ErrorCauseFixNot logged inNot authenticatedclawhub login``Slug is already takenSlug occupied by another skillRename slug or check ownershipSkill is hiddenSecurity scan in progressWait 60s and retryCTX_MAX_EXCEEDEDContent too largeTrim SKILL.md, move details to references/