- name
- clawhub-publish-doctor
- description
- Diagnose and mitigate ClawHub/ClawDHUB publish failures (auth, browser-login, missing dependencies, pending security-scan visibility errors, and wrong profile/skill URLs). Use when publishing skills to ClawHub fails, inspect reports temporary errors, or you need a safer publish+verify workflow with retries.
ClawHub Publish Doctor
Stabilize ClawHub publishing with preflight checks, safer publish commands, and post-publish verification that tolerates temporary registry states.
Quick workflow
- Run preflight checks:
- scripts/clawhub_preflight.sh
- If login/browser issues appear, follow
references/error-map.md. - Publish with retry-aware verification:
- scripts/clawhub_publish_safe.sh <skill_path> <slug> <name> <version> [changelog]
- If inspect still fails, classify the error with
references/error-map.mdbefore escalating.
Standard commands
Preflight
bash scripts/clawhub_preflight.shLogin (token-based, headless-safe)
clawhub login --token <clh_token>
clawhub whoamiSafe publish
bash scripts/clawhub_publish_safe.sh ./my-skill my-skill "My Skill" 1.0.0 "Initial release"Manual inspect
clawhub inspect my-skill --jsonRules
- Prefer token login in server/headless environments.
- Treat
inspecterrors right after publish as potentially transient for a few minutes. - Verify with both CLI (
clawhub inspect) and web URL (/skills/<slug>). - Use canonical URLs:
- Skill: https://clawhub.ai/skills/<slug> - Owner/slug: https://clawhub.ai/<handle>/<slug> - User profile (if available): https://clawhub.ai/users/<handle>
Resources
references/error-map.md: quick diagnosis for common failure signatures.scripts/clawhub_preflight.sh: dependency + environment checks.scripts/clawhub_publish_safe.sh: publish + retry verification wrapper.