npm i -g clawhub

# Login to ClawHub
clawhub login

# Verify authentication
clawhub whoami

# Basic search
clawhub search "postgres backups"

# Search with filters
clawhub search "database" --sort downloads
clawhub search "automation" --sort recent

# Install latest version
clawhub install my-skill

# Install specific version
clawhub install my-skill --version 1.2.3

# Install to custom directory
clawhub install my-skill --dir ./custom-skills

# Install multiple skills
clawhub install skill-one skill-two skill-three

# Verbose output
clawhub install my-skill --verbose

# Skip confirmation prompts
clawhub install my-skill --yes

# Custom registry
clawhub install my-skill --registry https://custom-registry.com

# Update single skill to latest
clawhub update my-skill

# Update to specific version
clawhub update my-skill --version 1.2.3

# Update all installed skills
clawhub update --all

# Force update (skip hash check)
clawhub update my-skill --force

# Batch update without prompts
clawhub update --all --no-input --force

# List all skills
clawhub list

# List with details
clawhub list --verbose

# List in JSON format
clawhub list --json

# Filter by pattern
clawhub list --filter "database"

# Basic publish
clawhub publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.2.0 \
  --changelog "Fixes + docs"

# Publish with description
clawhub publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.2.0 \
  --description "A helpful skill for automation" \
  --changelog "Added new features"

# Publish with tags
clawhub publish ./my-skill \
  --slug my-skill \
  --name "My Skill" \
  --version 1.2.0 \
  --tags "automation,productivity,database" \
  --changelog "Bug fixes and improvements"

# Patch version (1.2.3 → 1.2.4)
clawhub publish ./my-skill --slug my-skill --version patch

# Minor version (1.2.3 → 1.3.0)
clawhub publish ./my-skill --slug my-skill --version minor

# Major version (1.2.3 → 2.0.0)
clawhub publish ./my-skill --slug my-skill --version major

# Custom registry
export CLAWHUB_REGISTRY="https://custom-registry.com"

# Custom working directory
export CLAWHUB_WORKDIR="$HOME/my-skills"

# Custom install directory
export CLAWHUB_INSTALL_DIR="./skills"

# Enable debug logging
export CLAWHUB_DEBUG=true

{
  "registry": "https://www.clawhub.ai/",
  "workdir": ".",
  "installDir": "./skills",
  "autoUpdate": false,
  "verbose": false
}

# Install multiple skills from file
cat skills.txt | xargs -I {} clawhub install {}

# Update all skills silently
clawhub update --all --no-input --force

# Publish multiple versions
for dir in ./skills/*; do
  clawhub publish "$dir" --slug $(basename "$dir") --version patch
done

#!/bin/bash
# Auto-update script

# Update all skills
clawhub update --all --no-input

# Check for errors
if [ $? -eq 0 ]; then
  echo "All skills updated successfully"
else
  echo "Update failed"
  exit 1
fi

# GitHub Actions example
name: Publish Skill

on:
  push:
    tags:
      - 'v*'

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Setup Node
        uses: actions/setup-node@v2
        with:
          node-version: '18'
      
      - name: Install ClawHub CLI
        run: npm i -g clawhub
      
      - name: Publish Skill
        run: |
          clawhub publish . \
            --slug my-skill \
            --name "My Skill" \
            --version ${GITHUB_REF#refs/tags/v} \
            --changelog "Release ${GITHUB_REF#refs/tags/v}"
        env:
          CLAWHUB_AUTH: ${{ secrets.CLAWHUB_AUTH }}

# Clear npm cache
npm cache clean --force

# Reinstall clawhub
npm uninstall -g clawhub
npm i -g clawhub

# Verify installation
clawhub --version

# Re-login
clawhub logout
clawhub login

# Check credentials
clawhub whoami

# Manual auth (if needed)
export CLAWHUB_AUTH="your-auth-here"

# Force update with verbose output
clawhub update my-skill --force --verbose

# Reset local skill
rm -rf ./skills/my-skill
clawhub install my-skill

# Check registry connectivity
curl -I https://www.clawhub.ai/

# Common issues and solutions

# Error: Not authenticated
clawhub login

# Error: Slug already exists
# Use different slug or contact support if you own it

# Error: Invalid version
# Use semver format: 1.2.3

# Error: Missing SKILL.md
# Ensure skill directory has SKILL.md file

# Error: Network timeout
# Check internet connection and retry

# Authentication
clawhub login                    # Login to ClawHub
clawhub logout                   # Logout
clawhub whoami                   # Show current user

# Search & Discovery
clawhub search <query>           # Search skills
clawhub search <query> --sort    # Sort results
clawhub info <slug>              # Show skill details

# Installation
clawhub install <slug>           # Install skill
clawhub install <slug> --version # Install specific version
clawhub install <slug> --dir     # Custom install directory

# Updates
clawhub update <slug>            # Update single skill
clawhub update --all             # Update all skills
clawhub update --force           # Force update
clawhub update --no-input        # Skip confirmations

# Management
clawhub list                     # List installed skills
clawhub list --verbose           # Detailed list
clawhub list --json              # JSON output
clawhub uninstall <slug>         # Remove skill

# Publishing
clawhub publish <path>           # Publish skill
clawhub publish --slug           # Specify slug
clawhub publish --version        # Specify version
clawhub publish --changelog      # Add changelog

# Utilities
clawhub --version                # Show CLI version
clawhub --help                   # Show help
clawhub <command> --help         # Command-specific help