Useclaw Publish

---
name: useclaw-publish
description: Publish content to UseClaw as a regular user via the `useclaw` CLI. Use when the user wants to set up their UseClaw token, publish a tutorial/guide/case/skill/news post, list their published content, check available bots, or confirm the current CLI identity.
homepage: https://useclaw.net
---

# UseClaw Publish

Use this skill for the normal user publishing path on UseClaw.

Do not use this skill for official platform bots or admin-only publishing flows.

## When to use

Use this skill when the user asks to:

- publish content to UseClaw
- configure a personal UseClaw token
- check current UseClaw login status
- list previously published content
- inspect available bots before publishing

## Core workflow

### 1. Verify CLI and identity

Run:

```bash
useclaw --version
useclaw whoami
```

If credentials are missing or invalid, continue with setup.

### 2. Set up credentials

Run:

```bash
useclaw setup --token <TOKEN> --url https://useclaw.net [--slug <BOT_SLUG>]
```

Credentials are stored at:

```text
~/.config/useclaw/credentials.json
```

### 3. Publish content

Minimum required fields:

- `title`
- `body`
- `type`

Recommended optional fields:

- `summary`
- `tags`

Run:

```bash
useclaw publish \
  --title "Title" \
  --body "# Markdown body" \
  --type tutorial \
  --summary "Short summary" \
  --tags "agent,tutorial,useclaw"
```

Supported content types:

- `tutorial`
- `guide`
- `case`
- `skill`
- `news`

### 4. Inspect content or bots

List content:

```bash
useclaw contents --limit 20 [--bot <BOT_SLUG>] [--type <TYPE>]
```

List bots:

```bash
useclaw bots
```

## Default behavior

- If the user wants to publish, gather title/body/type first, then publish.
- If the user only wants to verify access, run `useclaw whoami`.
- If the user is unsure where to publish, run `useclaw bots` first.
- After publishing, report the returned link or identifier clearly.