> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Skills

Fertige Anleitungen, die deinem Coding-Agenten beibringen, häufige supastack-Aufgaben so zu erledigen, wie das Kit es erwartet.

## Was Skills sind

supastack bringt Agent Skills mit: kurze, aufgabenbezogene Anleitungen, die dein Coding-Agent lädt, wenn eine Aufgabe passt. Statt bei jedem Prompt die Konventionen des Kits zu raten, folgt der Agent denselben Schritten für Features, Zahlungen, Datenbankänderungen und Tests. Skills folgen dem offenen Agent-Skills-Format und funktionieren daher in Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI und anderen kompatiblen Agenten.


## Wo Skills liegen

Skills liegen in `.agents/skills/` — ein Ordner pro Skill mit einer `SKILL.md` darin. Identische Kopien liegen in `.claude/skills/` für Claude Code.


## Welche Agenten sie lesen

Codex, Cursor, GitHub Copilot, Gemini CLI und OpenCode lesen `.agents/skills/`. Claude Code liest `.claude/skills/`. Dein Agent wählt einen Skill automatisch, wenn deine Anfrage zu seiner Beschreibung passt — oder du nennst ihn: „use the `database-schema-change` skill“.


## Welche Repositories sie ausliefern

Das All-Platforms-Repository enthält jeden Skill. Die Web-, Mobile- und Desktop-Repositories enthalten die für sie zutreffenden Skills; End-to-End-Test- und CI-Skills werden nur mit dem All-Platforms-Repository ausgeliefert.


## Setup & Umgebung

Skills, um das Kit zu starten, zu deployen und zu konfigurieren.

- **Lokale Umgebung einrichten** (`local-environment-setup`) — beim Bootstrap oder Reparieren der lokalen Umgebung: erster Clone, fehlende oder kaputte .env, Postgres, Migrationen oder Ports.
- **Deployment und Env-Vars** (`deploy-and-env-vars`) — beim Deployen, bei der Wahl des Hosting-Ziels oder beim Hinzufügen oder Ändern einer Umgebungsvariable.
- **Eine Dependency hinzufügen** (`adding-a-dependency`) — beim Hinzufügen, Aktualisieren, Verschieben oder Entfernen einer npm-Dependency oder wenn CI die License- oder Audit-Prüfung nicht besteht.
- **Upstream-Upgrade** (`upgrading-from-upstream`) — wenn du ein neueres supastack-Release in ein darauf gebautes Produkt holst.


## Features bauen

Skills für neue Produktflächen auf jeder Plattform.

- **Ein Web-Feature hinzufügen** (`add-a-web-feature`) — für eine Produktseite oder einen Bereich mit eigenen Daten, Server Actions, Navigation und Tests.
- **Einen API-Endpunkt hinzufügen** (`add-an-api-endpoint`) — beim Hinzufügen oder Ändern eines öffentlichen /api/v1-Endpunkts, seiner OpenAPI-Doku oder von API-Key-Scopes.
- **Eine UI-Komponente hinzufügen** (`add-a-ui-component`) — für eine Section, einen Block, ein Formular-Control oder eine wiederverwendbare Komponente nach den Styling-Regeln des Kits.
- **Theme oder Style ändern** (`change-the-theme-or-style`) — wenn du das Aussehen des Produkts änderst: Design-Style, Color Pack, Dichte, Radius, Schrift oder Layout.
- **Marketing-Seite oder Blogpost hinzufügen** (`add-a-marketing-page-or-blog-post`) — beim Hinzufügen oder Bearbeiten einer öffentlichen Seite, Pricing-Seite, Legal-Seite, eines Blogposts oder Docs-Guides.
- **Einen mobilen Screen hinzufügen** (`add-a-mobile-screen`) — beim Hinzufügen oder Ändern eines Screens in der Expo-Mobile-App.
- **Eine Desktop-Fähigkeit hinzufügen** (`add-a-desktop-capability`) — bei Änderungen an der Tauri-Desktop-App: Fenster, Tray, globaler Shortcut oder Auto-Updates.
- **Eine Notification hinzufügen** (`add-a-notification`) — für eine In-App-Notification, Push-Notification oder einen Digest-Eintrag.


## Auth & Zahlungen

Skills für Sign-in, Billing und Pläne.

- **Eine Auth-Methode hinzufügen** (`add-an-auth-method`) — bei Änderungen am Sign-in: Social Provider, Magic Links, E-Mail-Codes, Passkeys oder Zwei-Faktor.
- **Einen Payment-Provider hinzufügen** (`add-a-payment-provider`) — beim Aktivieren eines Billing-Providers oder beim Schreiben eines neuen Billing-Adapters mit Checkout, Customer Portal und Webhooks.
- **Pläne und Preise ändern** (`change-plans-and-pricing`) — beim Hinzufügen, Umbenennen oder Ändern der Preise eines Plans: Preise, Trials, Seats, Entitlements, Usage-Limits oder Credits.


## Daten & Integrationen

Skills für Schema, KI, Jobs, E-Mail, Storage und Übersetzungen.

- **Datenbankschema ändern** (`database-schema-change`) — beim Hinzufügen oder Ändern einer Tabelle, Spalte, eines Index oder einer Relation und beim Generieren der Migration.
- **Ein KI-Feature hinzufügen** (`add-an-ai-feature`) — für einen Model-Call, ein Chat- oder Agent-Tool, einen durable AI Task, Budgets oder Bring-your-own-key.
- **Einen Background Job hinzufügen** (`add-a-background-job`) — für Arbeit, die nach einem Request, auf Timer oder pro Workspace läuft.
- **Eine E-Mail hinzufügen oder bearbeiten** (`add-or-edit-an-email`) — beim Hinzufügen oder Ändern einer transaktionalen E-Mail oder beim Wechsel des Providers, der sie versendet.
- **File Storage nutzen** (`use-file-storage`) — für Uploads oder gespeicherte Dateien wie Avatare, Logos oder Anhänge.
- **Übersetzungen hinzufügen** (`add-translations`) — beim Hinzufügen oder Ändern nutzerseitiger Texte, beim Übersetzen oder beim Hinzufügen einer Locale.


## Qualität & Versand

Skills für Tests, Verifikation, Reviews und CI.

- **Unit-Tests schreiben** (`writing-unit-tests`) — beim Schreiben oder Fixen von Vitest-Unit- oder Integrationstests.
- **E2E-Tests schreiben** (`writing-e2e-tests`) — beim Hinzufügen oder Fixen von Playwright-End-to-End-Tests, lokal oder in CI.
- **Änderungen verifizieren** (`verify-changes`) — vor dem Handoff, Commit oder Pull Request, um die richtigen Checks zu wählen und auszuführen.
- **Einen fehlgeschlagenen CI-Run debuggen** (`debugging-a-failing-ci-run`) — wenn ein GitHub-Actions-Run fehlschlägt und du die Ursache finden und fixen musst.
- **Einen PR reviewen** (`reviewing-a-pr`) — beim Review eines Pull Requests oder Diffs auf Korrektheit, Workspace-Isolation und Konventionen.


## Eigene hinzufügen

Lege einen Ordner an, dessen Name dem `name` im Frontmatter entspricht — mit einem `name` und einer `description`, die sagt, wann er zu nutzen ist. Kopiere ihn auch nach `.claude/skills/`, damit jeder Agent ihn findet.


## Weiter

[Mit einem Coding-Agenten bauen](https://supastack.dev/de/docs/web/agents.md)
