exec-clawhub-publish-doctor_skill

Overview

This skill diagnoses and mitigates exec-related failures when publishing skills to ClawHub and when running GitHub CLI repo queries. It bundles preflight checks, safer publish commands with retry-aware verification, and schema-aware GitHub search fallbacks to reduce false failures. Use it to stabilize publishing workflows and to classify transient vs persistent errors quickly.

How this skill works

It runs environment and dependency checks, verifies authentication state, and executes publish commands with built-in retries and post-publish inspection tolerant of temporary registry delays. For GitHub CLI search issues it runs a schema-aware wrapper that falls back to supported JSON fields to avoid errors like "Unknown JSON field". The skill also maps common error signatures to recommended remediation steps for faster triage.

When to use it

• Publishing a skill to ClawHub fails or returns inspect errors immediately after publish
• Automated CI/CD jobs hit browser-login or token authentication problems in headless environments
• GitHub CLI repo searches fail due to JSON-field schema mismatches
• You see pending security-scan visibility errors or temporary registry state inconsistencies
• You need to confirm whether an inspect error is transient before escalating

Best practices

• Use token-based login for servers and CI: clawhub login --token <clh_token>
• Run preflight checks before publishing: bash scripts/clawhub_preflight.sh
• Publish with the safe wrapper to get retries and tolerant verification
• Verify both CLI inspect and the canonical web URL to confirm visibility
• Prefer supported gh JSON fields like fullName when running searches

Example use cases

• CI pipeline publishes a new skill version and inspect immediately fails—use safe publish to retry and re-inspect
• Headless server cannot complete browser-login—switch to token login and run preflight checks
• gh search repos --json returns Unknown JSON field—use the schema-aware search wrapper
• Investigating transient pending security-scan visibility errors after a publish
• Bulk-archiving or backing up skills where stable publish and repo search behavior is required