Exec ClawHub Publish Doctor

---

name: exec-clawhub-publish-doctor description: "Diagnose and mitigate exec-related tooling failures around ClawHub publishing and GitHub CLI queries (auth, browser-login, missing dependencies, pending security-scan visibility errors, wrong profile/skill URLs, and gh JSON-field mismatch errors like Unknown JSON field). Use when publishing skills to ClawHub fails, inspect reports temporary errors, or GitHub CLI search commands fail due to field schema differences."

---

Exec ClawHub Publish Doctor

Stabilize ClawHub publishing with preflight checks, safer publish commands, and post-publish verification that tolerates temporary registry states.

Quick workflow

1. Run preflight checks: - scripts/clawhub_preflight.sh 2. If login/browser issues appear, follow references/error-map.md. 3. Publish with retry-aware verification: - scripts/clawhub_publish_safe.sh [changelog] 4. For GitHub search failures like Unknown JSON field, use: - scripts/gh_search_repos_safe.sh "" [limit] 5. If errors persist, classify with references/error-map.md before escalating.

Standard commands

Preflight

bash scripts/clawhub_preflight.sh

Login (token-based, headless-safe)

clawhub login --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

Safe GitHub repo search (schema-aware)

bash scripts/gh_search_repos_safe.sh "safe-exec skill" 15

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

For gh search repos --json failures, prefer fullName over unsupported aliases like nameWithOwner, or run scripts/gh_search_repos_safe.sh.

Use canonical URLs:

- Skill: https://clawhub.ai/skills/ - Owner/slug: https://clawhub.ai// - User profile (if available): https://clawhub.ai/users/

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.

scripts/gh_search_repos_safe.sh: resilient gh search repos wrapper with JSON-field mismatch fallback.

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

For gh search repos --json failures, prefer fullName over unsupported aliases like nameWithOwner, or run scripts/gh_search_repos_safe.sh.

Use canonical URLs:

- Skill: https://clawhub.ai/skills/ - Owner/slug: https://clawhub.ai// - User profile (if available): https://clawhub.ai/users/