# ClawHub Skills

ClawHub is a built-in skill system that chains multiple Tomba API calls into reusable workflows. Run complex multi-step operations with a single command.

## List Skills

```bash
tomba skill list
```

![tomba skill list](/cli/skill-list.svg)

## Built-in Skills

| Skill            | Workflow                                       | Description                                      |
| ---------------- | ---------------------------------------------- | ------------------------------------------------ |
| `find-email`     | finder -> verify                               | Find & verify someone's email from name + domain |
| `company-emails` | count -> search                                | Search all emails + department breakdown         |
| `enrich-verify`  | enrich -> verify -> sources                    | Full email intelligence report                   |
| `company-intel`  | status -> count -> search -> technology -> similar | Complete company dossier                     |
| `lead-gen`       | search                                         | Find decision makers by department               |
| `linkedin-intel` | linkedin -> enrich -> verify                   | Full intel from LinkedIn profile                 |
| `domain-check`   | status -> count                                | Quick domain health check                        |
| `author-verify`  | author -> verify                               | Find & verify article author email               |

## Run Skills

```bash
tomba skill run find-email --target stripe.com first_name=David last_name=Singleton
tomba skill run company-intel --target tomba.io
tomba skill run enrich-verify --target b.mohamed@tomba.io
tomba skill run lead-gen --target stripe.com department=sales
tomba skill run linkedin-intel --target "https://www.linkedin.com/in/mohamed-ben-rebia"
tomba skill run domain-check --target tomba.io
```

### Demo: domain-check

![tomba skill run domain-check](/cli/skill-domain-check.svg)

### Demo: find-email

![tomba skill run find-email](/cli/skill-find-email.svg)

### Demo: company-intel

![tomba skill run company-intel](/cli/skill-company-intel.svg)

### Demo: enrich-verify

![tomba skill run enrich-verify](/cli/skill-enrich-verify.svg)

## Skill Details

```bash
tomba skill info company-intel
```

![tomba skill info](/cli/skill-info.svg)

## Create & Share Custom Skills

```bash
# Interactive skill builder
tomba skill create

# Import a skill from YAML
tomba skill import my-workflow.yaml

# Export a skill to share
tomba skill export find-email > find-email.yaml

# Remove a custom skill
tomba skill remove my-custom-skill
```

### Demo: export

![tomba skill export](/cli/skill-export.svg)

## Custom Skill YAML Format

```yaml
name: my-skill
description: My custom workflow
author: user
version: 1.0.0
tags: [custom, email]
inputs:
    - name: domain
      description: Target domain
      type: domain
      required: true
steps:
    - id: search
      name: Search emails
      action: search
      params:
          domain: "{{input.domain}}"
          limit: "20"
    - id: verify_first
      name: Verify first result
      action: verify
      params:
          email: "{{steps.search.data.emails.0.email}}"
output:
    format: summary
    title: My Results
    fields: [email, score, verification]
```

### Demo: skill help

![tomba skill help](/cli/skill-help.svg)