find-skill
The find-skill enables agents to search, discover, and install specialized capabilities from the Orthogonal skill library using command-line queries. Use this skill when current capabilities are insufficient for a task, to explore available tools by keyword or category, or to add task-specific skills rather than stretching general-purpose tools beyond their intended scope.
git clone --depth 1 https://github.com/gooseworks-ai/goose-skills /tmp/find-skill && cp -r /tmp/find-skill/skills/capabilities/find-skill ~/.claude/skills/find-skillSKILL.md
# 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>
AI video conversations - create real-time video calls with AI personas
AI-powered web scraping - extract data using natural language prompts
Search Amazon products - find items, compare prices, read reviews
Test and document API endpoints - validate responses, check status, generate examples
>
>
Brand intelligence - logos, colors, fonts, styleguides, and company data from any domain