61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
# 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.
|