home / skills / openclaw / skills / skills-search

skills-search skill

safe

/skills/thesethrose/skills-search

This skill lets you search the skills.sh registry from the CLI to discover and compare agent skills quickly.

npx playbooks add skill openclaw/skills --skill skills-search

Review the files below or copy the command above to add this skill to your agents.

Files (4)

SKILL.md

3.1 KB

---
name: skills-search
description: Search skills.sh registry from CLI. Find and discover agent skills from the skills.sh ecosystem.
metadata:
  version: 1.0.4
  tags: ["search", "skills.sh", "cli"]
  clawdbot:
    requires:
      bins: ["node"]
    install:
      - id: "skill-install"
        kind: "skill"
        source: "clawdhub"
        slug: "skills-search"
        label: "Install skills-search skill"
---

# 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)

Overview

This skill provides a command-line interface to search the skills.sh registry and discover agent skills from the skills.sh ecosystem. It returns ranked results by install count and can show install commands to quickly add skills to your agent environment. The tool is designed for fast terminal lookups and integrates with the Clawdbot/Clawdhub workflow.

How this skill works

The CLI queries the skills.sh API to fetch skill metadata and sorts results by install count so the most popular skills appear first. It supports free-text search, a popular/leaderboard view, and an option to display the install command for each matching skill. You can pipe the result into your installation workflow by copying the provided install command or automating it with npx and the skills CLI.

When to use it

When you need to find an agent skill by name or topic from your terminal
When you want to browse the most popular skills quickly
When preparing to add skills to a Clawdbot/agent project
When you want the install command inline to speed up onboarding
When auditing or discovering archived skill versions across the ecosystem

Best practices

Search with specific keywords (e.g., tool or protocol names) to narrow results
Use --popular to explore proven community favorites before trying newer skills
Use --show-install or copy the displayed install command to automate installation
Confirm agent and installation scope interactively when invoking the skills CLI
Verify installed skill files in your agent workspace after installation

Example use cases

Find a PostgreSQL-related skill by searching 'postgres' and copy the install command
List the top 10 most-installed skills to evaluate common patterns and best practices
Discover frontend or web-design skills when assembling a web-focused agent
Automate a pipeline: search for 'react', then run the displayed npx install command
Audit a workspace by listing installed skill directories to confirm success

FAQ

Does this CLI use the official skills.sh API?

Yes, it queries the skills.sh API endpoint to retrieve skill metadata and install counts.

Can I install a skill directly from the search output?

The CLI can show the install command; you can copy it or pipe it into npx to install via the skills CLI or Clawdhub workflow.