| 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. |
Credential Fixture Review
python scripts/_secrets_inline.py is review material for the ClawHub Publish Doctor skill. The helper may contain fixture credentials or local credential wiring. Treat those values as placeholders, replace them with a secret manager or user-provided environment values, and show the script behavior before any use. Do not contact external services with embedded sample credentials.
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.md before escalating.
Standard commands
Preflight
bash scripts/clawhub_preflight.sh
Login (token-based, headless-safe)
clawhub login --token <clh_token>
clawhub whoami
Safe publish
bash scripts/clawhub_publish_safe.sh ./my-skill my-skill "My Skill" 1.0.0 "Initial release"
Manual inspect
clawhub inspect my-skill --json
Rules
- Prefer token login in server/headless environments.
- Treat
inspect errors 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.