Introduction
# Skills.sh Search CLI
Search skills from skills.sh registry directly from your terminal.
## Install (Clawdbot)
```bash clawdhub install skills-search ```
## Usage
```bash # Search for skills by name skills-search "postgres" skills-search "web design" skills-search "twitter"
# Show most popular skills skills-search --popular skills-search --popular --limit 10
# Search with install command skills-search "web design" --show-install ```
## Examples
``` ⯠skills-search "web design" š Searching skills.sh for "web design"...
ā web-design-guidelines (16,922 installs) Source: vercel-labs/agent-skills Install: npx skills add vercel-labs/agent-skills
ā frontend-design (566 installs) Source: anthropics/skills Install: npx skills add anthropics/skills ```
### Popular Skills
``` ⯠skills-search --popular --limit 5 š Top 5 most popular skills:
ā vercel-react-best-practices (22,475 installs) Source: vercel-labs/agent-skills
ā web-design-guidelines (17,135 installs) Source: vercel-labs/agent-skills
ā upgrading-expo (1,192 installs) Source: expo/skills ... ```
## Automation (Clawdbot)
### Step 1: Search for a skill
```bash npx @thesethrose/skills-search "react" ```
### Step 2: Install found skill via skills CLI
After finding a skill, install it using the `skills` CLI:
```bash npx skills add vercel-labs/agent-skills ```
**TUI Navigation Guidance:**
The `skills` CLI uses an interactive menu. Watch for prompts and navigate accordingly:
1. **Select skills** ā Toggle skills you want with `space`, confirm with `enter` 2. **Select agents** ā Navigate with `up`/`down`, select `Clawdbot` with `space`, confirm with `enter` 3. **Installation scope** ā Choose Project (recommended) with `enter` 4. **Confirm** ā Press `enter` to proceed
**Important:** The TUI may change. Pay attention to the menu options and select `Clawdbot` when prompted for agents. If unsure about any selection, ask the user for guidance.
### Step 3: Verify installation
```bash ls ~/.clawdbot/workspace/.agents/skills/ ```
## Adding Your Own Skill
Skills.sh automatically indexes GitHub repos containing `SKILL.md` files. To add your skill:
1. **Create a skill folder** with `SKILL.md` in your GitHub repo 2. **Publish to ClawdHub** for Clawdbot-specific discovery: ```bash clawdhub publish ./your-skill/ --slug your-skill --name "Your Skill" --version 1.0.0 ``` 3. **Install in Clawdbot:** ```bash clawdhub install your-skill ```
## Notes
- Queries https://skills.sh/api/skills (official skills.sh API) - Results sorted by install count (most popular first) - **Clawdbot-only**: Install via `clawdhub install skills-search` - Skills.sh leaderboard requires GitHub repo (not needed for ClawdHub-only skills)