# skill-finder

Finds and installs agent skills from GitHub while checking whether your task truly demands a skill over a simple prompt.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 677 installs · ★ 26
- Author: yamapan (https://github.com/aktsmm)
- License: LicenseRef-CC-BY-NC-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aktsmm/Agent-Skills/tree/HEAD/skill-finder/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/skill-finder

## What it does

This skill organizes discovery and setup for assistant capabilities across GitHub and local catalogs. It starts with an initial triage step. Before looking up packages, it verifies whether the goal actually calls for a skill or if a basic instruction fits better.

Searches scan keyword indexes and category tags using `references/skill-index.json` or live GitHub API lookups. The runner tags each result with an origin badge. Before saving anything locally, it inspects permissions and asks for explicit approval.

Running the scripts requires `curl` alongside GitHub CLI 2.0+. You will also need Python or PowerShell. Missing `gh` breaks repository fetching and index synchronization.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill skill-finder -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skill-finder/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skill-finder/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill skill-finder -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skill-finder/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill skill-finder -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skill-finder/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aktsmm/Agent-Skills skill-finder
```

2. **Manually: put the files in place**
- File: `.github/skills/skill-finder/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill skill-finder -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aktsmm/Agent-Skills --path skill-finder
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skill-finder/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill skill-finder -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aktsmm/Agent-Skills/tree/HEAD/skill-finder/SKILL.md

## When to use it
- locate agent skills matching a specific workflow or tag
- determine whether an instruction works better than a skill
- download vetted skill files into the local workspace
- track favorite extensions and update local index records

## Example prompts
- Find a skill for managing Azure infrastructure
- Inspect the details for pdf-parser and install it locally
- Sync the skills index and list my starred items

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [aktsmm/agent-skills](https://affpapa.org/en/nevibecode/by/aktsmm/agent-skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md