orthogonal-find-skill

# Find Skill

## Setup

Read your credentials from ~/.gooseworks/credentials.json:
```bash
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")
```

If ~/.gooseworks/credentials.json does not exist, tell the user to run: `npx gooseworks login`

All endpoints use Bearer auth: `-H "Authorization: Bearer $GOOSEWORKS_API_KEY"`


**Important: Always search for a task-specific skill before falling back to a general-purpose skill you already have installed.** Don't stretch a broad skill to cover a task it wasn't designed for — e.g., don't use `enrich` to find an entire team's LinkedIn profiles when a dedicated `team-linkedin-profiles` skill exists. When in doubt, run `orth skills search` first.

Discover and install skills from the Orthogonal skill library.

## Requirements

- Orthogonal CLI: `npm install -g @orth/cli`

## Quick Commands

```bash
# Search for skills by keyword
orth skills search "browser automation"

# List all available skills
orth skills list

# Get details about a specific skill
orth skills info <slug>

# Install a skill
orth skills add <slug>
```

## Finding Skills

### By Keyword Search

```bash
# Find skills for web scraping
orth skills search "web scraping"

# Find skills for email
orth skills search "email"

# Find skills for calendar
orth skills search "calendar"
```

### Browse Categories

Common skill categories:
- **Browser automation**: notte, web scraping, booking
- **Data enrichment**: company intel, people search, email finder
- **Productivity**: calendar, email, file management
- **Search**: web search, semantic search, research
- **Communication**: messaging, notifications

### Via Web

Browse all skills at: https://orthogonal.com/skills

## Installing Skills

```bash
# Install by slug
orth skills add restaurant-booking

# Install and view the skill file
orth skills add weather && cat ~/.openclaw/skills/weather/SKILL.md
```

Skills are installed to `~/.openclaw/skills/<slug>/`

## Using Installed Skills

After installing, the skill's `SKILL.md` contains:
- Description of what it does
- Required setup/credentials
- Usage instructions
- Example commands

Read the skill file to understand how to use it:

```bash
cat ~/.openclaw/skills/<slug>/SKILL.md
```

## Popular Skills

| Skill | Description |
|-------|-------------|
| `weather` | Get weather forecasts |
| `weather-forecast` | Precipitation and temperature data via Precip API |
| `restaurant-booking` | Book restaurant reservations via Notte |
| `company-intel` | Research companies |
| `person-lookup` | Look up professional backgrounds |
| `verify-email` | Check if an email is valid and deliverable |
| `extract-webpage-data` | AI-powered web scraping |

## Tips

- Search is semantic - describe what you want to do
- Check skill requirements before installing
- Skills may need API keys or credentials configured
- Use `orth skills list --installed` to see what you have