Communitygithub.com

deangileroremix/videoremix.vip2

Implementiere Clerk-Authentifizierung für native Android-Apps mit Kotlin und Jetpack Compose unter Verwendung von clerk-android Quellmustern. Verwende vorgefertigte AuthView/UserButton oder benutzerdefinierte API-gesteuerte Auth-Abläufe. Nicht geeignet für Expo oder React Native Projekte.

Was ist videoremix.vip2?

Diese Fähigkeit implementiert Clerk-Authentifizierung in nativen Android-Projekten unter Verwendung von Kotlin und Jetpack Compose. Sie folgt den aktuellen Mustern des `clerk-android` SDK und der offiziellen Dokumentation. Die Fähigkeit unterstützt zwei Hauptabläufe: den Prebuilt-Flow mit vorgefertigten `AuthView`/`UserButton` Komponenten für die schnellste Integration und den Custom-Flow mit vollständiger Kontrolle über die API-gesteuerte Authentifizierung. Sie stellt sicher, dass die Entwickler einen gültigen Clerk-Publishable-Key verwenden, die richtigen Android-Artefakte (`clerk-android-ui` für Prebuilt, `clerk-android-api` für Custom) installieren und die Android Quickstart-Voraussetzungen (Native API, minimale SDK/Java-Version, Manifest-Berechtigungen, Clerk-Initialisierung in der Application-Klasse) erfüllen. Die Fähigkeit vermeidet hartcodierte Annahmen über Authentifizierungsfaktoren oder Social Provider und nutzt stattdessen die Laufzeitfähigkeiten von Clerk, um das Verhalten dynamisch an die Dashboard-Konfiguration anzupassen. Sie ist nicht für Expo oder React Native Projekte geeignet; bei Erkennung dieser Frameworks wird zur allgemeinen Clerk-Setup-Fähigkeit weitergeleitet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/deangilmoreremix/videoremix.vip2/tree/HEAD/.agents/skills/clerk-android

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Clerk Android (nativ)

Diese Fähigkeit implementiert Clerk in nativen Android-Projekten durch Befolgung der aktuellen clerk-android SDK und Dokumentationsmuster.

Aktivierungsregeln

Aktiviere diese Fähigkeit, wenn eine der folgenden Bedingungen zutrifft:

  • Der Benutzer fragt explizit nach Android, Kotlin, Jetpack Compose oder nativer mobiler Clerk-Implementierung auf Android.
  • Das Projekt scheint eine native Android-App zu sein (z. B. build.gradle(.kts) mit Android-Plugins, AndroidManifest.xml, app/src/main/java, Compose-UI-Dateien).

Aktiviere diese Fähigkeit nicht, wenn eine der folgenden Bedingungen zutrifft:

  • Das Projekt ist Expo.
  • Das Projekt ist React Native.

Wenn Signale für Expo/React Native vorhanden sind, leite zur allgemeinen Setup-Fähigkeit weiter.

Was wird benötigt?

AufgabeReferenz
Vorgefertigte AuthView / UserButton (am schnellsten)references/prebuilt.md
Benutzerdefinierte API-gesteuerte Auth-Abläufe (volle Kontrolle)references/custom.md

Kurzanleitung

SchrittAktion
1Bestätige, dass der Projekttyp nativ Android und nicht Expo/React Native ist
2Bestimme den Ablauf-Typ (prebuilt oder custom) und lade die passende Referenzdatei
3Stelle sicher, dass ein echter Clerk-Publishable-Key existiert (oder frage den Entwickler)
4Stelle sicher, dass die richtigen Clerk-Artefakte für den ausgewählten Ablauf installiert sind
5Lies die offizielle Android-Kurzanleitung und überprüfe die erforderliche Einrichtung (Native API, min SDK/Java, Manifest, Initialisierung)
6Überprüfe die clerk-android Quell-/Beispielmuster, die für den ausgewählten Ablauf relevant sind
7Implementiere den Ablauf, indem du nur der Checkliste der ausgewählten Referenz folgst

Entscheidungsbaum

Benutzer fragt nach Clerk in Android/Kotlin
    |
    +-- Expo/React Native Projekt erkannt?
    |     |
    |     +-- JA -> Diese Fähigkeit nicht verwenden
    |     |
    |     +-- NEIN -> Fortfahren
    |
    +-- Vorhandene Auth-UI erkannt?
    |     |
    |     +-- Vorgefertigte Ansichten erkannt -> Lade references/prebuilt.md
    |     |
    |     +-- Benutzerdefinierter Ablauf erkannt -> Lade references/custom.md
    |     |
    |     +-- Neue Implementierung -> Frage Entwickler nach prebuilt/custom, dann lade passende Referenz
    |
    +-- Stelle sicher, dass Publishable-Key und SDK-Initialisierungspfad vorhanden sind
    |
    +-- Stelle sicher, dass die richtigen Android-Artefakte installiert sind
    |
    +-- Überprüfe die Quickstart-Voraussetzungen im Projekt
    |
    +-- Implementiere unter Verwendung der ausgewählten Ablauf-Referenz

Ablauf-Referenzen

Nachdem der Ablauf-Typ bekannt ist, lade genau eine davon:

Vermische die beiden Referenzen nicht in einer einzigen Implementierung, es sei denn, der Entwickler fragt explizit nach einem Hybrid-Ansatz.

Interaktionsvertrag

Vor allen Implementierungsänderungen muss der Agent beides haben:

  • Ablauf-Auswahl: prebuilt oder custom
  • einen echten Clerk-Publishable-Key

Fehlt einer der Werte in der Benutzeranfrage/im Kontext:

  • frage den Benutzer nach dem/den fehlenden Wert(en)
  • pausiere und warte auf die Antwort
  • bearbeite keine Dateien und installiere keine Abhängigkeiten

Überspringe die Frage nur, wenn der Benutzer den Wert bereits explizit in dieser Unterhaltung angegeben hat.

Quellgesteuerte Vorlagen

Hardcodiere keine Implementierungsbeispiele in dieser Fähigkeit. Überprüfe vor der Implementierung die aktuellen clerk-android Quellen/Dokumentationen für die installierte SDK-Version.

AnwendungsfallQuelle der Wahrheit
SDK-Artefakte und Abhängigkeitsaufteilung (clerk-android-api vs clerk-android-ui)clerk-android README und Android-Installationsdokumente
SDK-Initialisierung und Publishable-Key-EinbindungAndroid-Kurzanleitung und source/api/.../Clerk.kt
Verhalten von vorgefertigter Auth und Profilsource/ui/.../AuthView.kt, source/ui/.../UserButton.kt und Prebuilt-Beispiel
Benutzerdefinierte Auth-Abläufe und Faktorbehandlungsource/ui/auth/*, source/api/auth/* und Custom-Flows-Beispiel
Funktions-/Feature-Gating basierend auf InstanzeinstellungenÖffentliche Felder von Clerk (z. B. enabledFirstFactorAttributes, socialProviders, isGoogleOneTapEnabled, mfaIsEnabled) und Umgebungsmodell-Quelle
Erforderliche Android-Setup-ChecklisteOffizielle Android-Kurzanleitung (/docs/android/getting-started/quickstart)

Ausführungshürden (Nicht überspringen)

  1. Keine Implementierungsänderungen vor den Voraussetzungen
  • Bearbeite keine Projektdateien, bis der Ablauf-Typ bestätigt ist und ein gültiger Publishable-Key verfügbar ist.
  1. Fehlender Ablauf oder fehlender Key muss eine Frage auslösen
  • Wenn die Ablauf-Auswahl fehlt, frage explizit: vorgefertigte Ansichten oder benutzerdefinierter Ablauf.
  • Wenn der Publishable-Key fehlt/Platzhalter/ungültig ist, frage explizit nach einem echten Key.
  • Fahre nicht fort, bis beide Antworten gegeben sind.
  1. Einbindungsmodus des Publishable-Keys ist obligatorisch
  • Standardmäßig binde den vom Entwickler bereitgestellten Key direkt in Clerk.initialize(...) ein.
  • Führe keine Geheimnisverwaltungsindirektion ein, es sei denn, dies wird explizit angefordert.
  1. Installationsrichtlinie für Artefakte ist obligatorisch
  • Prebuilt-Ablauf: verwende clerk-android-ui (enthält API).
  • Benutzerdefinierter Ablauf: verwende clerk-android-api, es sei denn, Prebuilt-Komponenten werden explizit angefordert.
  • Wenn Clerk-Artefakte fehlen, füge die neueste stabile verfügbare Version hinzu.
  1. Einhaltung der Android-Kurzanleitung ist obligatorisch
  • Überprüfe, ob die Native API für die Clerk-App aktiviert ist.
  • Überprüfe, ob die Android-Anforderungen aus der Kurzanleitung im Projekt implementiert sind (minimale SDK- und Java-Zielversion, Manifest-Internetberechtigung, app-level Clerk-Initialisierung).
  • Überprüfe, ob die App auf die SDK-Initialisierung wartet (Clerk.isInitialized), bevor sie den Auth-bereiten Zustand annimmt.
  1. Fähigkeitsgesteuertes Verhalten ist obligatorisch
  • Verwende den Clerk-Laufzeit-Funktions-/Einstellungszustand (z. B. aktivierte Faktoren/Sozialanbieter/MFA-Flags), um das Ablaufverhalten zu steuern.
  • Hardcodiere keine Faktorannahmen, die mit der Dashboard-Konfiguration in Konflikt geraten könnten.
  1. Disziplin der Referenzdatei ist obligatorisch
  • Sobald ein Ablauf ausgewählt ist, folge nur dieser Ablauf-Referenzdatei für die Implementierung und Überprüfung.
  1. Strukturparität des benutzerdefinierten Ablaufs ist obligatorisch
  • Für den custom-Ablauf behalte die mehrstufige Auth-Abfolge und faktor-spezifische Behandlung bei (kein einzelnes All-Felder-Formular standardmäßig).
  • Halte UI, Zustandsorchestrierung und Clerk-API-Integration in separaten Modulen.
  1. Präferenz für Prebuilt ist obligatorisch, wenn ausgewählt
  • Für den prebuilt-Ablauf erstelle keine Auth-Formulare mit benutzerdefinierten API-Aufrufen neu, es sei denn, dies wird explizit angefordert.
  • Verwende AuthView/UserButton als Standardbausteine.

Arbeitsablauf

  1. Erkenne nativ Android vs. Expo/React Native.
  2. Wenn der Ablauf-Typ nicht explizit angegeben wurde, frage den Benutzer nach prebuilt oder custom.
  3. Wenn der Publishable-Key nicht explizit angegeben wurde, frage den Benutzer danach.
  4. Warte auf beide Antworten, bevor du Dateien änderst.
  5. Lade die passende Ablauf-Referenzdatei.
  6. Stelle sicher, dass der Clerk.initialize(...) Pfad und die Publishable-Key-Einbindung gültig sind.
  7. Stelle sicher, dass Abhängigkeiten/Artefakte zum ausgewählten Ablauf passen.
  8. Überprüfe die Android-Kurzanleitungsanforderungen und wende fehlende Einstellungen im Projekt an.
  9. Implementiere unter Verwendung der ausgewählten Referenz-Checkliste.
  10. Überprüfe unter Verwendung der ausgewählten Referenz-Checkliste plus gemeinsamer Hürden.

Häufige Fallstricke

EbeneProblemVermeidung
KRITISCHFehlende Ablauf-Auswahl vor der Implementierung nicht erfragenFrage nach prebuilt vs custom und warte vor Änderungen
KRITISCHFehlenden Publishable-Key vor der Implementierung nicht erfragenFrage nach dem Key und warte vor Änderungen
KRITISCHImplementierung beginnen, bevor der Ablauf-Typ bestätigt istBestätige zuerst den Ablauf und lade die passende Referenz
KRITISCHAndroid-Kurzanleitungs-Voraussetzungen überspringenÜberprüfe und wende die erforderliche Einrichtung aus der offiziellen Android-Kurzanleitung an
KRITISCHFehlender app-level Clerk.initialize(...) AufrufInitialisiere Clerk vom Application-Startpfad aus
HOCHFalsches Artefakt für den gewählten AblaufPrebuilt: clerk-android-ui; benutzerdefiniert: clerk-android-api
HOCHAuth-UI rendern, bevor die SDK-Initialisierung abgeschlossen istSteuere die UI mit dem Clerk.isInitialized Zustand
HOCHAuth-Faktoren/Sozialanbieter hartcodierenSteuere das Verhalten von Clerk-Laufzeit-Fähigkeitsfeldern
HOCHDiese Fähigkeit für Expo/React Native verwendenErkenne und leite vor der Implementierung weiter

Siehe auch

  • clerk Fähigkeit für Clerk-Routing auf oberster Ebene
  • clerk-setup Fähigkeit für frameworkübergreifende Kurzanleitungseinrichtung
  • https://github.com/clerk/clerk-android
  • https://clerk.com/docs/android/getting-started/quickstart

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

deangilmoreremix/videoremix.vip2

Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering. Triggers on: astro clerk, clerk astro middleware, astro protected page, clerk island component, astro API route auth, clerk astro SSR.

deangilmoreremix/videoremix.vip2

Clerk Backend REST API explorer and executor. Browse tags, inspect endpoint schemas, and execute authenticated requests. Use when listing users, managing organizations, or calling any Clerk API endpoint.

deangilmoreremix/videoremix.vip2

Clerk Billing for subscription management - render Clerk's PricingTable and in-app checkout drawer, configure subscription plans, seat-limit plans for B2B, feature entitlements with has(), and billing webhooks. Use for SaaS monetization, plan gating, checkout flows, trials, invoicing, and subscription lifecycle management.

deangilmoreremix/videoremix.vip2

Chrome Extension auth with @clerk/chrome-extension -- popup/sidepanel setup, syncHost for OAuth/SAML via web app, createClerkClient for service workers and headless extensions, stable CRX ID. Triggers on: Chrome extension auth, Plasmo clerk, popup sign-in, syncHost, background service worker token, createClerkClient, headless extension.

deangilmoreremix/videoremix.vip2

>- Operate the Clerk CLI (`clerk` binary) for authentication, user/org/session management, deploy verification, instance config, env keys, and any Clerk Backend or Platform API call. Use when the user mentions Clerk management tasks, "list clerk users", "create a clerk user", "update organization", "pull clerk config", "clerk env pull", "clerk doctor", "clerk deploy", "clerk deploy status", "clerk api", or any ad-hoc Clerk API request. Prefer the CLI over raw HTTP: it handles auth, key resolution, app/instance targeting, and formatting automatically.

deangilmoreremix/videoremix.vip2

Custom authentication flows and component appearance - hooks (useSignIn, useSignUp), themes, colors, fonts, CSS. Use for custom sign-in/sign-up flows, appearance styling, visual customization, branding.

deangilmoreremix/videoremix.vip2

Agent skill / project related to launch or product demo video: deangilmoreremix/videoremix.vip2

Verwandte Skills