# Cursor Agent-Skills Setup

Dieses Projekt enthält Automatisierungsskripte, um die drei empfohlenen Agenten-Skills aus dem Repository [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills) herunterzuladen und im Zielverzeichnis für Cursor (standardmäßig `.cursor/rules`) abzulegen.

## Funktionsweise & Enthaltene Skills

Die Skripte bieten eine interaktive Auswahl im Terminal, über die du jeden der 24 Skills aus dem Repository einzeln aktivieren oder deaktivieren kannst.

* **Automatische Erkennung:** Die Skripte prüfen das Zielverzeichnis auf bereits vorhandene Skill-Dateien und wählen diese im Menü automatisch als aktiv aus.
* **Standard-Skills:** Falls noch keine Skills im Zielverzeichnis existieren, sind die folgenden drei bewährten Best-Practice-Skills standardmäßig vorausgewählt:
  1. **Test-Driven Development** (`test-driven-development.md`)
  2. **Code Review and Quality** (`code-review-and-quality.md`)
  3. **Incremental Implementation** (`incremental-implementation.md`)
* **Interaktive Steuerung:**
  * Eingabe einer **Zahl (1-24)** toggelt den entsprechenden Skill.
  * Eingabe von **`a`** wählt alle Skills aus.
  * Eingabe von **`n`** deaktiviert alle Skills.
  * Eingabe von **`d`** (oder einfach **Eingabetaste/Enter**) wendet die Auswahl an und startet den Download/Sync.
  * Eingabe von **`q`** bricht den Vorgang ohne Änderungen ab.

Nach Bestätigung werden alle aktivierten Skills heruntergeladen oder aktualisiert, und alle nicht (mehr) ausgewählten Skills werden automatisch aus dem Zielverzeichnis gelöscht.

Durch das Platzieren dieser Dateien im Ordner `.cursor/rules` deines Projekts werden diese Regeln automatisch in den Kontext des Cursor AI-Agenten geladen.

---

## Verwendung

Die Skripte bieten ein interaktives Auswahlmenü direkt in deiner Shell, erstellen automatisch das Zielverzeichnis (falls noch nicht vorhanden) und laden die neuesten Versionen der ausgewählten Skills direkt aus dem GitHub-Repository herunter.

### Option 1: PowerShell (Windows)

1. Öffne die PowerShell im Hauptverzeichnis deines Zielprojekts.
2. Führe das Skript aus:
   ```powershell
   # Standard: Lädt die Skills in den Ordner '.cursor/rules' im aktuellen Verzeichnis
   & "C:\Users\mbusc\source\repos\cursor-skills-setup\setup-skills.ps1"

   # Alternativ: Mit Angabe eines benutzerdefinierten Zielverzeichnisses
   & "C:\Users\mbusc\source\repos\cursor-skills-setup\setup-skills.ps1" -TargetDir "C:\dein\projekt\.cursor\rules"
   ```

### Option 2: Bash (Linux / macOS / Git Bash)

1. Öffne das Terminal im Hauptverzeichnis deines Zielprojekts.
2. Führe das Skript aus:
   ```bash
   # Standard: Lädt die Skills in den Ordner '.cursor/rules' im aktuellen Verzeichnis
   bash /c/Users/mbusc/source/repos/cursor-skills-setup/setup-skills.sh

   # Alternativ: Mit Angabe eines benutzerdefinierten Zielverzeichnisses
   bash /c/Users/mbusc/source/repos/cursor-skills-setup/setup-skills.sh ./mein-zielordner
   ```

---

## Voraussetzungen

* **Bash-Skript**: Benötigt `curl` oder `wget`.
* **PowerShell-Skript**: Benötigt mindestens PowerShell 3.0.