Skills exec-clawhub-publish-doctor

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.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bluebirdback/exec-clawhub-publish-doctor" ~/.claude/skills/clawdbot-skills-exec-clawhub-publish-doctor && rm -rf "$T"

manifest: skills/bluebirdback/exec-clawhub-publish-doctor/SKILL.md

source content

Exec 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]

For GitHub search failures like

Unknown JSON field

, use:

scripts/gh_search_repos_safe.sh "<query>" [limit]

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

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

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/<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.
```
scripts/gh_search_repos_safe.sh
```
: resilient
```
gh search repos
```
wrapper with JSON-field mismatch fallback.