skills-search/SKILL.md

name, description, metadata

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

Skills.sh Search CLI

Search skills from skills.sh registry directly from your terminal.

Install (Bot)

skills install skills-search

Usage

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

Step 1: Search for a skill

npx @thesethrose/skills-search "react"

Step 2: Install found skill via skills CLI

After finding a skill, install it using the skills CLI:

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 Bot 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 Bot when prompted for agents. If unsure about any selection, ask the user for guidance.

Step 3: Verify installation

ls ~/.bot/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 Skills for Bot-specific discovery:

   skills publish ./your-skill/ --slug your-skill --name "Your Skill" --version 1.0.0
   

3. Install in Bot:

   skills install your-skill
   

Notes

• Queries https://skills.sh/api/skills (official skills.sh API)
• Results sorted by install count (most popular first)
• Bot-only: Install via skills install skills-search
• Skills.sh leaderboard requires GitHub repo (not needed for Skills-only skills)