# Skill Finder

Helps users discover and install agent skills from the open skills ecosystem (skills.sh).

- Repository: https://github.com/dp-archive/archive (1107 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-03-04
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add dp-archive/archive --skill skill-finder -g -a claude-code -y`
Codex: `npx skills add dp-archive/archive --skill skill-finder -g -a codex -y`
Cursor: `npx skills add dp-archive/archive --skill skill-finder -g -a cursor -y`
Gemini CLI: `npx skills add dp-archive/archive --skill skill-finder -g -a gemini-cli -y`

## Description

Helps users discover and install agent skills from the open skills ecosystem (skills.sh). Use when users ask 'how do I do X', 'find a skill for X', 'is there a skill that can...', want to search for tools/templates/workflows, or express interest in extending agent capabilities.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Skill Finder

Discover and install agent skills from the [skills.sh](https://skills.sh) open ecosystem into Skill Compose.

## When to Use This Skill

Activate when users:
- Ask "how do I do X?" where an existing skill might help
- Request "find a skill for X" or "is there a skill for X?"
- Ask "can you do X?" for specialized tasks (poster design, data analysis, etc.)
- Want to search for tools, templates, or workflows
- Mention needing help with a specific domain that might have a community skill

## Available Scripts

### 1. Search Skills, `find_skills.py`

Search the skills.sh ecosystem for skills matching a query.

```bash
python scripts/find_skills.py <query> [--limit N]
```

**Example:**
```bash
python scripts/find_skills.py "react performance"
python scripts/find_skills.py "docker" --limit 5
```

**Output:** JSON array of matching skills with `name`, `source` (owner/repo), `installs` count, and `url` (skills.sh link).

### 2. Install Skill, `add_skill.py`

Download a skill from GitHub and register it in Skill Compose.

```bash
python scripts/add_skill.py <owner/repo@skill-name>
```

**Example:**
```bash
python scripts/add_skill.py "vercel-labs/agent-skills@vercel-react-best-practices"
```

**What it does:**
1. Parses the `owner/repo@skill-name` identifier
2. Tries multiple GitHub paths to locate the skill (`skills/<name>/`, `<name>/`, root)
3. Downloads all skill files (SKILL.md, scripts/, references/, assets/)
4. Saves to the local `skills/` directory
5. Registers the skill in Skill Compose via the import-local API
6. The skill is immediately available for use in Agent Presets

## CRITICAL: Never Combine Questions with Tool Calls

The rest: https://github.com/dp-archive/archive/blob/HEAD/seed_skills/skill-finder/SKILL.md