Verify Publish CH

SKILL.md

---
name: verify-publish
version: 2.0.0
description: Verification test for ClawHub CLI publish async schema fix
tags: [testing, ci-cd]
---

# Verify Publish Skill

## Overview

This skill provides comprehensive verification capabilities for the ClawHub CLI publish pipeline after the async API response schema fix. It validates that the CLI correctly handles both the legacy synchronous format `{skillId, versionId}` and the new asynchronous format `{status, attemptId, slug, version}`.

## Architecture

The verification operates in three phases:

1. **Schema validation** - Confirms `ApiV1PublishResponseSchema` accepts both response formats
2. **CLI integration** - Tests `clawhub skill publish` command with `--json` and default output
3. **Python client** - Validates `clawhub_client.py` handles `acceptLicenseTerms` and async responses

## Commands

### Publish a Skill (CLI)

```bash
clawhub skill publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.0.0 \
  --changelog "Initial release"
```

### Publish with JSON Output

```bash
clawhub skill publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.0.0 \
  --json
```

### Device Flow Login

```bash
clawhub login --device --no-browser
```

## Configuration

| Variable | Description | Default |
|----------|-------------|---------|
| `CLAWHUB_REGISTRY` | Registry API base URL | `https://clawhub.ai` |
| `CLAWHUB_CONFIG_PATH` | Token config file path | `~/.config/clawhub/config.json` |
| `CLAWHUB_DISABLE_TELEMETRY` | Disable install telemetry | unset |

## Error Handling

| Error | Cause | Resolution |
|-------|-------|------------|
| `401 Unauthorized` | Invalid or revoked token | Run `clawhub login` |
| `skillId: invalid value` | CLI schema mismatch with API | Update CLI or patch schemas.js |
| `Skill content is too thin` | Insufficient documentation | Add meaningful content to SKILL.md |

## Changelog

### 2.0.0
- Full verification suite for async schema fix
- Comprehensive error handling documentation
- Configuration reference table