# Skill Finder

> Browse and discover Claude Code skills, agents, and plugins from the marketplace — ranked by rating — that are NOT yet installed. Use when the user is new and has few/no specialists installed, asks "what plugins/skills are available for X", "find me a skill for Y", "what should I install", "browse the marketplace", or when agent-router finds no installed tool that fits. Returns a ranked shortlist…

- **Type:** Skill
- **Install:** `agentstack add skill-ramananani-agent-router-skill-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [RamanaNani](https://agentstack.voostack.com/s/ramananani)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [RamanaNani](https://github.com/RamanaNani)
- **Source:** https://github.com/RamanaNani/agent-router/tree/main/skills/skill-finder
- **Website:** https://github.com/RamanaNani/agent-router

## Install

```sh
agentstack add skill-ramananani-agent-router-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 — marketplace discovery

Where `agent-router` routes among tools you ALREADY have, `skill-finder` discovers
tools you DON'T have yet. It searches the marketplace, ranks candidates by rating,
and hands back the exact install command. Built for a new user whose `~/.claude/`
is empty or thin.

## When to use
- A new user wants to know what's worth installing for their kind of work.
- The user asks "find/browse skills for X", "what plugin does Y", "what should I install".
- `agent-router` found nothing installed scoring ≥ 25 → fall through to here.

## Procedure

### 1. Capture the need
One sentence: the domain + task (code review, testing, security, infra, data,
research, design…). Note any language/framework constraint.

### 2. Don't recommend what they already have
Quickly scan installed tools (the session list, `~/.claude/`, `./.claude/`, and
installed plugins) so the shortlist is all NEW installs. If a good specialist is
already installed, say so and route to it instead (defer to `agent-router`).

### 3. Gather candidates — real ones only
Merge two sources:
- **Curated catalog**: `data/marketplace.json` (verified entries + ratings).
- **Live search** (preferred, for freshness):
  - GitHub: repositories matching `claude code  plugin|skill|agent`,
    sorted by stars (use the GitHub search tool or a web search).
  - Web: ` claude code skill OR plugin OR subagent`.
  For each candidate capture: name, what it does, a **rating signal** (GitHub
  stars or curated score), the source URL, and how to install it.

NEVER invent a repo, package, or star count. List only candidates that appear in
the catalog or in a real search result, and include the URL so the user can verify.

### 4. Rank (0-100)
- **Relevance (0-50)**: match to the task/domain.
- **Rating (0-35)**: GitHub stars (log-scaled) or curated `rating`. Unknown → 10.
- **Maintenance (0-15)**: recent commits / not archived. Unknown → 7.

Drop anything below relevance 15 — discovery should stay on-topic.

### 5. Present the shortlist
Top 3-5 as a table: rank, name, what it does, rating (e.g. `★ 1.2k` or `score 80`),
source link. Then, for the top pick, show the **exact install command**:
```
/plugin marketplace add /
/plugin install @
```
or `npx ` when the project ships an npm installer.

### 6. Offer to install
Installing plugins is done by the USER via `/plugin …` — you cannot run those
slash commands for them. Lay out the 1-2 commands and offer to walk through it.
If the pick is an `npx` installer, you may run it via Bash once the user confirms.

### 7. Log the discovery (internal dogfooding)
Append ONE JSONL line so gaps in the installed toolset are tracked over time:
```bash
mkdir -p ~/.claude/agent-router/logs
echo '{"ts":"'"$(date -u +%FT%TZ)"'","skill":"skill-finder","need":"","domain":"","recommended":"","source":"","rating":"","installed":false,"feedback":""}' >> ~/.claude/agent-router/logs/decisions.jsonl
```
Set `installed` to true once the user installs it. These rows reveal which
capabilities the user repeatedly needs but doesn't have — the roadmap.

## Rules
- Honesty over coverage: a short list of real, linked tools beats a long invented one.
- Always show the source URL and the install command — discovery is useless without them.
- State the rating's basis (GitHub stars vs. curated score) so it isn't mistaken for gospel.
- If live search is unavailable and the catalog is thin, say so and show what you have.
- After install, hand off to `agent-router` to actually route the task.

## Source & license

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

- **Author:** [RamanaNani](https://github.com/RamanaNani)
- **Source:** [RamanaNani/agent-router](https://github.com/RamanaNani/agent-router)
- **License:** MIT
- **Homepage:** https://github.com/RamanaNani/agent-router

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-ramananani-agent-router-skill-finder
- Seller: https://agentstack.voostack.com/s/ramananani
- 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%.
