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 via CLI (Recommended)
clawhub install openclaw/skills/skills/bluebirdback/exec-clawhub-publish-doctorWhat This Skill Does
The exec-clawhub-publish-doctor is a specialized diagnostic and recovery tool designed for developers managing OpenClaw agent skills. Its primary purpose is to stabilize the publishing lifecycle on ClawHub by automating preflight checks, wrapping publishing commands in retry logic, and providing a safety layer for common CLI failures. It addresses frequent pain points such as authentication timeouts, browser-login issues in headless environments, and fragile GitHub CLI JSON schema mismatches. By serving as an orchestrator for existing internal scripts, this skill ensures that publishing failures are diagnosed instantly through a standardized error-mapping system, preventing manual debugging cycles when the registry is in a transient state.
Installation
To integrate this doctor skill into your local environment, use the OpenClaw command-line interface provided in the source repository. Execute the following command in your terminal:
clawhub install openclaw/skills/skills/bluebirdback/exec-clawhub-publish-doctor
Ensure that you have the required permissions and that your local environment satisfies the dependencies listed in the scripts/clawhub_preflight.sh file before running the tool for the first time.
Use Cases
- Automated Preflight: Use before every deployment to verify local environment configuration and dependency health.
- Headless Authentication: Manage ClawHub session tokens in CI/CD pipelines without needing a graphical browser for login.
- Schema Resilience: Automatically resolve "Unknown JSON field" errors when performing
ghsearches during skill discovery. - Post-Publish Verification: Automatically inspect published skills to confirm they are live, accounting for propagation delays.
- Error Diagnosis: Quickly resolve recurring issues by referencing the
error-map.mdlibrary included with the tool.
Example Prompts
- "I am getting an 'Unknown JSON field' error while trying to list repositories for my agent, can you help fix the search query?"
- "My skill just finished uploading but
clawhub inspectsays it doesn't exist. Please run the publish doctor and verify the status." - "I'm setting up a headless CI environment; can you help me authenticate to ClawHub using a token and run a preflight check?"
Tips & Limitations
- Patience with Propagation: Always check the web URL (
https://clawhub.ai/skills/<slug>) manually if the CLI reports a 404 immediately after a successful publish, as registry cache can cause transient failures. - Token Security: In production environments, prioritize the
clawhub login --tokencommand over interactive logins. - Maintenance: Ensure you pull the latest version of the
openclaw/skillsrepository periodically to keep theerror-map.mdand script wrappers updated with current API changes.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-bluebirdback-exec-clawhub-publish-doctor": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, code-execution
Related Skills
claude-to-free
Migrate OpenClaw from Claude subscription OAuth to a free or cheap model provider (OpenRouter, Gemini, Ollama). Use when the user says Claude stopped working, gets an auth error, mentions the Anthropic April 2026 subscription ban, or asks to switch models without paying Anthropic more.
youtube-transcript-pipeline-lite
Run a lightweight YouTube transcript workflow: transcribe, attribution cleanup, translation, and packaging with minimal tooling. Use for repeatable transcript handoff tasks when you need a concise, auditable process over custom automation.
clawhub-publish-doctor
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.
claw-history
Provide a chronological history of all actions the agent has taken from the beginning (birth) until now. Use when the user asks for full lifetime timeline/accountability, "from birth until now," "everything you've done so far," "full action log," or equivalent chronological-history requests.
youtube-transcript-pipeline
Generate, clean, correct, translate, and package YouTube interview transcripts with speaker-attributed timestamps into reusable deliverables. Use for workflows involving Deepgram transcription, diarization correction, bilingual output, and structured folder packaging for handoff.