Skill Quick Publish

Automate the full skill publishing pipeline: duplicate check → Bear dev-log sync → GitHub push → ClawHub publish.

Prerequisites

• clawhub CLI installed and authenticated (clawhub whoami)
• git CLI available with push access to target repo
• (Optional) grizzly CLI for Bear notes sync on macOS

Workflow

Run the main orchestrator script:

bash SKILL_DIR/scripts/publish.sh \x3Cskill-path> [options]

Options

Environment Variables

• SKILL_GH_REPO — Default GitHub repo (e.g., user/skills)
• SKILL_BEAR_TAG — Bear note tag for dev logs (default: skill-dev)
• GRIZZLY_TOKEN_FILE — Path to Bear API token (default: ~/.config/grizzly/token)

Steps in Detail

1. Duplicate Check

Validates skill name uniqueness against:

• Locally installed skills (~/.openclaw/skills/)
• ClawHub registry (clawhub search)

Exits with error if a conflicting skill exists, unless --force is passed.

2. Bear Notes Sync

Creates or appends a dev-log note in Bear:

• Title: [Skill Dev] \x3Cskill-name>
• Tag: value of SKILL_BEAR_TAG
• Content: timestamp, version, changelog summary

On non-macOS or when grizzly is unavailable, prints a structured log line to stdout instead (so the pipeline continues).

3. GitHub Push

Commits and pushes the skill directory to the configured GitHub repo:

1. Clones/pulls the target repo to a temp directory
2. Copies skill files into the repo under skills/\x3Cskill-name>/
3. Commits with message: feat(skill): publish \x3Cskill-name> v\x3Cversion>
4. Pushes to the target branch

4. ClawHub Publish

Runs clawhub publish with the skill path, slug, name, version, and changelog.

Error Handling

• Each step logs ✅ on success, ❌ on failure
• The pipeline stops on the first failure unless --continue-on-error is set
• Bear sync failure is non-fatal by default (warns and continues)

Examples

# Full publish
bash scripts/publish.sh ./my-skill --repo user/skills --version 1.0.0

# Dry run
bash scripts/publish.sh ./my-skill --repo user/skills --dry-run

# Skip Bear and GitHub, only ClawHub
bash scripts/publish.sh ./my-skill --repo user/skills --skip-bear --skip-github

# Using env var for repo
SKILL_GH_REPO=user/skills bash scripts/publish.sh ./my-skill