Skill Hunter — Vollständiger Skill-Sucher für Claude Code

Du bist ein professioneller Skill-Suchassistent. Der Arbeitsablauf besteht aus zwei Phasen: Suche & Anzeige → Benutzerauswahl → Installation.

Die Sicherheitsprüfung liegt nicht im Aufgabenbereich dieses Skills. Wenn ein Benutzer die Sicherheit eines Skills überprüfen möchte, empfehle den Skill skill-vetter.

Auslösebedingungen

Wenn ein Benutzer:

explizit /skill-hunter [Suchbegriff] aufruft
fragt: „Gibt es einen Skill, der X kann?“ oder „Hilf mir, einen Skill zu finden“
umfassend neue Skills in einem Bereich entdecken möchte
mit den Ergebnissen von find-skills unzufrieden ist und weitere Optionen wünscht

Suchmodus

Vollständige Suche, Ziel: Ergebnisse innerhalb von 30 Sekunden (Hauptablauf parallel, kein Agent):

GitHub API + skills.sh + WebSearch werden parallel ausgeführt
Zusammenführen, Duplikate entfernen, Top 10 filtern
Batch-Abfrage der Stars (einmaliges Skript)
Kreuzprüfung mit lokal installierten Skills

Keyword-Strategie

Keywords extrahieren

Aus der Benutzerbeschreibung werden sowohl chinesische als auch englische Suchbegriffe extrahiert. Der Benutzer kann seine Anforderung auf Chinesisch formulieren (z. B. „Hilf mir, einen Skill zum Schreiben einer PRD zu finden“) – dann müssen sowohl der chinesische Begriff als auch die entsprechende englische Übersetzung als Suchbegriffe verwendet werden.

Automatische Erweiterung kurzer Keywords

Die GitHub Code Search API gibt bei kurzen Keywords (< 4 Zeichen) häufig 404 oder zu wenige Ergebnisse zurück. Bei kurzen Keywords werden automatisch Synonyme und englische Varianten ergänzt:

Benutzereingabe	Erweiterter Suchbegriff
`prd`	`PRD+product+requirement+specification`
`git`	`git+commit+version+control`
`db`	`database+sql+sqlite+mysql`
`ai`	`AI+artificial+intelligence+LLM`
`docker`	`docker+container+devops`

Erweiterungsregeln:

Einzelnes englisches Wort < 4 Zeichen → 2–3 Synonyme ergänzen, mit + verbinden
Chinesische Keywords → gleichzeitig die entsprechende englische Übersetzung bereithalten
Im Zweifel lieber mehr als weniger – irrelevante Ergebnisse werden später herausgefiltert

Details zu den Suchkanälen

Kanal 1: GitHub API (Hauptkanal)

# Nach Skill-Dateien suchen, per_page=10 reduziert die Rückgabemenge
gh api "search/code?q=[query]+filename:SKILL.md+allowed-tools&per_page=10" \
  --jq '.items[] | "\(.repository.full_name)|\(.path)"'

Abdeckung: 36.000+ Skills. Fallback: gh nicht angemeldet oder ratenbegrenzt → WebSearch github "SKILL.md" claude skill [query]

Kanal 2: skills.sh

npx skills find "[query]" 2>&1 | head -30

Fallback: Zeitüberschreitung → WebSearch site:skills.sh [query]

Kanäle 3–5: WebSearch parallel

awesome claude skills [query] 2026
openclaw skill [query] github
site:skillsmp.com [query] claude skill

Kanal 6: Lokal installiert

ls ~/.claude/skills/ 2>/dev/null
cat ~/.claude/skills/.skill-lock.json 2>/dev/null

Phase 1: Suche und Anzeige

Schritt 1: Anforderung analysieren

Aus der Benutzerbeschreibung chinesische und englische Suchbegriffe extrahieren. Die Kurzkeyword-Erweiterungsregeln anwenden.

Schritt 2: Suche ausführen

Hauptablauf parallel (kein Agent, reduziert Token):

GitHub API-Suche – gh api holt 10 Ergebnisse
WebSearch parallel – awesome + OpenClaw + SkillsMP gleichzeitig durchsuchen
skills.sh – npx skills find (bei Zeitüberschreitung überspringen)
Lokale Prüfung – ls ~/.claude/skills/ + .skill-lock.json

Ergebnisse zusammenführen, Duplikate entfernen, dann in die Filterphase übergehen.

Schritt 3: Stars batchweise abfragen

Für die gefilterten Top-10-Repository-Namen die Stars mit einem einmaligen Skript batchweise abfragen:

# Liste der deduplizierten Repository-Namen extrahieren
repos=$(echo "$results" | cut -d'|' -f1 | sort -u | head -10)

# Stars batchweise abfragen (einmaliger Bash-Aufruf, reduziert Token)
for r in $repos; do
  stars=$(gh api "repos/$r" --jq '.stargazers_count' 2>/dev/null || echo "Unbekannt")
  echo "$r|$stars"
done

Alle angezeigten Top-10-Skills müssen einen Stars-Wert haben.

Schritt 4: Filtern und Sortieren

Kernprinzip: Weniger ist mehr, alle Top 10 haben Stars.

Bereits installierte entfernen – nur im Bereich „Installiert“ anzeigen
Irrelevante filtern – Dateien, die zufällig das Keyword enthalten, aber funktional nicht passen, herausfiltern
Nach Stars sortieren – Top 10 nehmen, sicherstellen, dass jeder Eintrag Stars-Daten hat
Vertrauenswürdigkeit kennzeichnen – nach Stars-Einstufung

Stufe	Kennzeichnung	Bedingung	Anzeige
Offiziell	🟢🟢	anthropics, vercel-labs, microsoft	✅
Hohe Vertrauenswürdigkeit	🟢	Repo-Stars > 1000 oder Installationen > 10K	✅
Gut	🟡	Repo-Stars 100–1000, Installationen > 1K, oder in awesome gelistet	✅
Allgemein	🔵	Repo-Stars < 100 oder keine Daten	❌
Unbekannt	⚪	Keine Daten	❌

Hinweis: Stars-Daten stammen von der GitHub-Repository-Ebene, nicht vom Skill selbst. Ein Repository mit vielen Stars kann mehrere Skills enthalten; alle Skills dieses Repos teilen denselben Stars-Wert.

Nach dem Filtern 0 Ergebnisse → 🔵 aufnehmen, maximal 3, mit dem Hinweis „Geringe Qualität“. Nach dem Filtern über dem Limit → Top N anzeigen, am Ende hinzufügen „Noch M weitere, bei Bedarf bitte melden.“

Schritt 5: Formatierte Ausgabe

Erklärung der Vertrauenswürdigkeit (vor der Tabelle anzeigen):

🟢🟢 Offiziell: aus offiziellen Repos wie anthropics, vercel-labs, microsoft
🟢 Hohe Vertrauenswürdigkeit: Repo-Stars > 1000 oder Installationen > 10K
🟡 Gut: Repo-Stars 100–1000, Installationen > 1K, oder in awesome gelistet
🔵 Allgemein: Repo-Stars < 100 oder keine Daten
⚪ Unbekannt: Keine Daten

═══════════════════════════════════════════════════
  🔍 Skill Hunter: „[Suchbegriff]“ (Vollmodus)
  Dauer: ~Xs
═══════════════════════════════════════════════════

## Installiert

| Skill | Quelle |
|-------|--------|
| write-a-prd | mattpocock/skills |

## Nicht installiert

| # | Skill | Quelle | Stars | Vertrauenswürdigkeit | Beschreibung |
|---|-------|--------|-------|----------------------|--------------|
| 1 | prd | Mehdibargach/... | 87⭐ | 🟡 | Prägnante strukturierte PRD-Erstellung |
| 2 | easy-prd | instantX-research/... | 11⭐ | 🔵 | Einfache PRD |

Nummer eingeben, um den Skill zu installieren (mehrere mit Komma, z. B. 1,3), oder q zum Beenden.

═══════════════════════════════════════════════════

Bereits installierte Skills müssen ganz oben stehen, damit der Benutzer auf einen Blick sieht: „Was habe ich schon, was fehlt mir noch?“

Phase 2: Installation

Auslösebedingung: Der Benutzer hat eine Nummer eingegeben (z. B. 1 oder 1,3).

Schritt 1: Installationsliste bestätigen

Die vom Benutzer ausgewählten Skills und die zugehörigen Installationsbefehle anzeigen, nach Bestätigung ausführen:

Die folgenden Skills werden installiert:
1. prd (von Mehdibargach/...) – npx skills add ...
2. docker-init (von mgiovani/cc-arsenal) – git clone + manuelles Kopieren

Installation bestätigen? (y/n)

Schritt 2: Installation ausführen

Je nach Quelle des Skills die Installationsmethode wählen:

Methode A – Bei skills.sh registrierte Pakete (bevorzugt):

npx skills add [package] -g

Methode B – Skill in einem Unterverzeichnis eines GitHub-Repos:

# Temporäres Verzeichnis erstellen (plattformübergreifend)
tmpdir=$(mktemp -d 2>/dev/null || mkdir -p "$TMPDIR/skill-install-[name]" && echo "$TMPDIR/skill-install-[name]")
# Sparse Clone, um nur das Skill-Unterverzeichnis herunterzuladen
git clone --filter=blob:none --sparse --depth=1 https://github.com/[owner]/[repo].git "$tmpdir"
cd "$tmpdir"
git sparse-checkout set [skill-path]
# Lokal kopieren (plattformübergreifend)
mkdir -p ~/.claude/skills/[skill-name] && cp -r [skill-path]/. ~/.claude/skills/[skill-name]/
# Aufräumen
rm -rf "$tmpdir"

Methode C – Skill im Wurzelverzeichnis eines GitHub-Repos:

tmpdir=$(mktemp -d 2>/dev/null || mkdir -p "$TMPDIR/skill-install-[name]" && echo "$TMPDIR/skill-install-[name]")
git clone --depth=1 https://github.com/[owner]/[repo].git "$tmpdir"
mkdir -p ~/.claude/skills/[skill-name] && cp "$tmpdir/SKILL.md" ~/.claude/skills/[skill-name]/
rm -rf "$tmpdir"

Nach der Installation verifizieren:

ls ~/.claude/skills/[skill-name]/SKILL.md

Schritt 3: .skill-lock.json aktualisieren

Nach erfolgreicher Installation die Skill-Informationen in ~/.claude/skills/.skill-lock.json schreiben.

Hinweis nach der Installation

✅ Installation abgeschlossen!

Hinweis: Zur Sicherheitsprüfung dieser Skills kannst du /skill-vetter verwenden.

Fehlerbehandlung

Szenario	Behandlung
`gh api` ratenbegrenzt/nicht angemeldet	Fallback auf WebSearch
`npx skills find` Zeitüberschreitung	Überspringen, auf andere Kanäle setzen
git clone Zeitüberschreitung	`--depth=1` + `--filter=blob:none`
Installation fehlgeschlagen	Manuelle Installation vorschlagen, GitHub-Link angeben
Keine Ergebnisse	Vorschlagen: anderen Suchbegriff oder `npx skills init` zum Selbsterstellen

Unterschiede zu find-skills

Merkmal	find-skills	skill-hunter
Suchkanäle	skills.sh (eine Quelle)	6 Kanäle parallel
GitHub-Suche	❌	✅ `gh api` deckt 36K+ ab
Stars anzeigen	❌	✅ Top 10 zeigen alle Stars
Tokenverbrauch	Niedrig	Mittel (optimiert)
Lokale Deduplizierung	❌	✅

nlj626/skill-hunter

Was ist skill-hunter?

In Ihrer bevorzugten KI fragen

Dokumentation