---
name: "github-gem-seeker"
description: "Suche auf GitHub nach erprobten Lösungen statt das Rad neu zu erfinden — für universelle Probleme."
---

# github-gem-seeker

Search GitHub for battle-tested solutions instead of reinventing the wheel.

## Wann verwenden

Bei Problemen, die universell genug sind, dass Open-Source-Devs sie wahrscheinlich schon gelöst haben — **besonders**:

- 🎥 **Format-Conversion:** Video/Audio/Image/Document
- ⬇️ **Media-Downloading:** YouTube, Twitter, Instagram, generic
- 📁 **File-Manipulation:** Batch-Rename, Splitting, Merging
- 🕷️ **Web-Scraping / Archiving**
- 🤖 **Automation-Scripts**
- 🛠️ **CLI-Tools** für Standard-Aufgaben

**Bevor du Custom-Code schreibst → diesen Skill nutzen.**

## Workflow

### 1. Problem klassifizieren
"Ist das ein Standard-Problem, das viele haben?" → Ja → GitHub suchen.

### 2. Suche

```
web_search query="<problem> github" count=10
```

Oder gezielt:
```
web_search query="site:github.com <keywords> stars:>500"
```

Direkt GitHub-API (via `web_fetch`):
```
https://api.github.com/search/repositories?q=<query>&sort=stars
```

### 3. Bewertungs-Kriterien

| Kriterium | Schwelle |
|---|---|
| ⭐ Stars | ≥500 für etablierte Tools, ≥100 für nischig |
| 🔄 Last commit | innerhalb letzter 12 Monate |
| 📖 README | klar dokumentiert, Quick-Start vorhanden |
| 🐛 Issues | nicht überflutet mit ungelösten Critical-Bugs |
| 📜 License | MIT/Apache/BSD bevorzugt, GPL je nach Use-Case ok |

### 4. Installation

**Bevorzugt in Reihenfolge:**
1. **Standalone-Binary** (z.B. yt-dlp, ffmpeg) — via Package-Manager
2. **Package-Manager** (apt, brew, pip, npm, cargo, go install)
3. **Docker** (wenn Dependencies komplex)
4. **From source** (nur wenn nichts anderes geht)

Bei Remote-Install-Scripts: Datei zuerst herunterladen, inspizieren und erst dann lokal ausführen — niemals direkt in eine Shell pipen.

### 5. Verifikation

Nach Installation:
- `<tool> --version` checken
- Minimal-Beispiel aus README laufen lassen
- Erst dann auf echtem User-Input nutzen

## Hall of Fame (Gems)

| Problem | Gem |
|---|---|
| YouTube/Twitter/X/Insta download | **yt-dlp** |
| Video/Audio convert | **ffmpeg** |
| Image manipulation | **ImageMagick**, **VIPS** |
| PDF-Parsing | **pdftotext**, **mupdf**, **pdfplumber** |
| Web-Scraping | **playwright**, **scrapy**, **httpx** |
| Website-Archive | **monolith**, **wget --mirror**, **wayback-machine-downloader** |
| JSON-Tools | **jq**, **gron** |
| Document-Convert | **pandoc** |
| Audio-Transcription | **whisper.cpp**, **faster-whisper** |
| Image-OCR | **tesseract** |
| File-Sync | **rsync**, **rclone** |
| GitHub-CLI | **gh** |

## Fallstricke

- ⚠️ Repos mit >5 Jahre kein Commit → wahrscheinlich tot
- ⚠️ "Awesome lists" sind kuratiert aber nicht immer aktuell
- ⚠️ Bei Security-Tools: Source review vor Install
- ⚠️ Forks bevorzugen nur wenn Original nicht maintained
- ⚠️ Stars ≠ Qualität (manche viral, manche obskure Gold-Nuggets)

## Verbotene Patterns

- ❌ "Ich schreib das schnell selbst" bei Standard-Problemen
- ❌ Tool installieren ohne Verifikation (`--version`)
- ❌ Remote-Install-Scripts ohne vorherige Inspektion ausführen
