# Skill Finder

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-dp-archive-archive-skill-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dp-archive](https://agentstack.voostack.com/s/dp-archive)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [dp-archive](https://github.com/dp-archive)
- **Source:** https://github.com/dp-archive/archive/tree/main/seed_skills/skill-finder

## Install

```sh
agentstack add skill-dp-archive-archive-skill-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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  [--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 
```

**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//`, `/`, 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

When you ask the user a question or present results for them to review, your response MUST end with text only. Do NOT include any tool call (execute_code, bash, etc.) in the same response. The user needs a chance to read and reply. If you combine a question with a tool call, the tool executes immediately without waiting — this breaks the conversation flow.

**WRONG** (never do this):
> "Should I install X?" + [execute_code: install X]

**CORRECT** (always do this):
> Turn 1: "Should I install X?" (text only, no tool calls)
> Turn 2: User says "yes"
> Turn 3: [execute_code: install X]

## How to Help Users Find and Install Skills

Each step below MUST be a separate conversation turn. Never combine steps.

### Step 1: Understand the Need
Identify what domain and specific task the user needs help with.

### Step 2: Search
Run `find_skills.py` with relevant keywords. Try multiple queries if the first doesn't yield good results. Even if the user names an exact skill, always search first to find the correct source/owner and verify it exists.

### Step 3: Present Results and Ask
Show the user the found skills with:
- Skill name
- Source repository
- Install count (popularity indicator)
- skills.sh link for more details

Ask which skill(s) they want to install. **End your response here — no tool calls.**

### Step 4: Confirm
When the user picks a skill, repeat back what you will install and ask for confirmation. **This must be a text-only response with no tool calls.** Wait for the user to reply.

### Step 5: Install
Only after the user confirms in a **separate message**, run `add_skill.py`. Report the result.

## Common Skill Categories

| Category | Example Queries |
|----------|----------------|
| Web Development | react, nextjs, vue, css, tailwind, html |
| Testing | testing, jest, playwright, cypress |
| DevOps | docker, kubernetes, ci-cd, terraform |
| Documentation | docs, readme, markdown, api-docs |
| Code Quality | lint, refactor, code-review, typescript |
| Design | ui, design, figma, accessibility |
| Data & ML | pandas, data-analysis, machine-learning |
| Productivity | git, automation, workflow |

## Tips for Effective Searches

- Use specific domain keywords: "react performance" instead of just "fast"
- Try alternative terms if first search yields few results: "testing" → "jest" → "playwright"
- Popular skill sources include: `vercel-labs/agent-skills`, `google-labs-code/stitch-skills`
- Check install counts — higher counts generally indicate more mature skills

## When No Skills Are Found

1. Acknowledge that no matching skill exists yet
2. Offer to help the user directly with their task
3. Suggest the user could create a custom skill for their use case using `skill-creator`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dp-archive](https://github.com/dp-archive)
- **Source:** [dp-archive/archive](https://github.com/dp-archive/archive)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-dp-archive-archive-skill-finder
- Seller: https://agentstack.voostack.com/s/dp-archive
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.