HKUDS/DeepTutor · error · HubError

{self.name}: publish failed (HTTP {response.status_code}): {

Error message

{self.name}: publish failed (HTTP {response.status_code}): {detail}

What it means

Raised by ClawHubProvider.publish when the hub accepts the request but responds with HTTP >= 400. The message embeds the status code plus the hub's own error detail (JSON 'error' field, or the first 200 chars of the body).

Source

Thrown at deeptutor/services/skill/hub.py:481

        accepts it. Surfaces the API's JSON ``error`` message on failure.
        """
        url = f"{self._base_url}/skills"
        try:
            response = self._client.post(
                url,
                data={"slug": slug, "version": version, **fields},
                files={"zip": ("package.zip", zip_bytes, "application/zip")},
                headers={"Authorization": f"Bearer {token}"},
            )
        except httpx.HTTPError as exc:
            raise HubError(f"{self.name}: publish request failed: {exc}") from exc
        if response.status_code >= 400:
            detail = ""
            try:
                detail = str(response.json().get("error") or "")
            except ValueError:
                detail = response.text[:200]
            raise HubError(f"{self.name}: publish failed (HTTP {response.status_code}): {detail}")
        try:
            return response.json()
        except ValueError:
            return {}

    def list_my_skills(self, token: str) -> list[dict[str, Any]]:
        """List the authenticated user's skills via ``GET /skills?owner=me``.

        Each row carries the slug, current ``version`` (latest), the full
        ``versions`` list (for rollback) and the current classification (for
        pre-filling an upgrade's tagging) — see ``buildMySkills`` on the hub.
        """
        url = f"{self._base_url}/skills"
        try:
            response = self._client.get(
                url, params={"owner": "me"}, headers={"Authorization": f"Bearer {token}"}
            )
        except httpx.HTTPError as exc:

View on GitHub (pinned to 3e82f13042)

Solutions

1. Bump the version in SKILL.md frontmatter (or pass --version) and retry
2. Re-mint the token on the hub web UI if 401/403
3. Check ownership of the slug and rename if taken
4. Fix any field validation errors named in the detail string

Example fix

# before: version: 1.0.0 already published
# after (SKILL.md frontmatter):
version: 1.0.1

# pre-check version novelty where possible
listing = hub.detail(slug)
if listing.get("version") == my_version: bump_version()

try:
    hub.publish(slug, version, token, ...)
except HubError as e:
    if "HTTP 409" in str(e): bump_and_retry()
    elif "HTTP 401" in str(e) or "HTTP 403" in str(e): relogin()
    else: raise

When it happens

Trigger: Publishing with an invalid/expired bearer token (401), a slug owned by someone else (403), a version that already exists (409), or validation failures (422) on fields like slug/version.

Common situations: Re-publishing the same version instead of bumping it in SKILL.md frontmatter; token minted for a different account; missing required publish fields; slug name collision on the hub.

Related errors

• {self.name}: publish request failed: {exc}
• {self.name}: unrecognised search response shape
• {self.name}: catalog returned invalid JSON
• {self.name}: unrecognised catalog response shape
• {self.name}: skill detail returned invalid JSON

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/fa49313a7653e55e. Report an issue: GitHub.