Communitygithub.com

deangilmoreremix/videoremix.vip2

Implementa autenticación Clerk para aplicaciones nativas Android usando Kotlin y Jetpack Compose con patrones de clerk-android. Úsalo para AuthView/UserButton predefinidos o flujos de autenticación personalizados basados en API. No lo uses para proyectos Expo o React Native.

¿Qué es videoremix.vip2?

Esta habilidad implementa Clerk en proyectos Android nativos siguiendo los patrones actuales del SDK clerk-android y su documentación. Es útil para desarrolladores que necesitan añadir autenticación robusta a aplicaciones Android con Kotlin y Jetpack Compose, ofreciendo dos enfoques principales: componentes preconstruidos (AuthView/UserButton) para integración rápida, o flujos de autenticación totalmente personalizados basados en la API de Clerk. La habilidad soporta plataformas Android nativas y se activa automáticamente cuando detecta un proyecto Android nativo (build.gradle.kts, AndroidManifest.xml, Compose UI), pero se desactiva para proyectos Expo o React Native, redirigiendo a la habilidad de configuración general. Su funcionamiento se basa en una estricta secuencia de pasos: primero confirma que el proyecto sea Android nativo, luego determina el tipo de flujo (prebuilt o custom) preguntando al usuario si no está definido, asegura que exista una clave publicable real de Clerk, instala los artefactos correctos según el flujo (clerk-android-ui para prebuilt, clerk-android-api para custom), verifica los requisitos previos del inicio rápido oficial de Android, e implementa el flujo siguiendo exclusivamente la guía de referencia seleccionada sin mezclar enfoques. La habilidad impone reglas estrictas como no editar archivos hasta tener flujo y clave confirmados, inicializar Clerk desde Application, esperar a Clerk.isInitialized antes de mostrar la UI de autenticación, y usar las capacidades dinámicas de Clerk (factores habilitados, proveedores sociales, MFA) en lugar de valores fijos.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Clerk Android (Nativo)

Esta habilidad implementa Clerk en proyectos Android nativos siguiendo los patrones actuales del SDK clerk-android y su documentación.

Reglas de Activación

Activa esta habilidad cuando se cumpla cualquier condición:

  • El usuario pide explícitamente una implementación de Clerk para Android, Kotlin, Jetpack Compose o móvil nativo en Android.
  • El proyecto parece ser Android nativo (por ejemplo, build.gradle(.kts) con plugins de Android, AndroidManifest.xml, app/src/main/java, archivos de UI Compose).

No actives esta habilidad cuando se cumpla cualquier condición:

  • El proyecto es Expo.
  • El proyecto es React Native.

Si se detectan señales de Expo/React Native, redirige a la habilidad de configuración general.

¿Qué Necesitas?

TareaReferencia
AuthView / UserButton predefinidos (más rápido)references/prebuilt.md
Flujos de autenticación personalizados basados en API (control total)references/custom.md

Inicio Rápido

PasoAcción
1Confirmar que el tipo de proyecto es Android nativo y no Expo/React Native
2Determinar el tipo de flujo (prebuilt o custom) y cargar el archivo de referencia correspondiente
3Asegurar que existe una clave publicable real de Clerk (o preguntar al desarrollador)
4Asegurar que los artefactos correctos de Clerk están instalados para el flujo seleccionado
5Leer la guía de inicio rápido oficial de Android y verificar la configuración requerida (API nativa, SDK mínimo/Java, manifiesto, inicialización)
6Inspeccionar las fuentes/ejemplos de clerk-android relevantes para el flujo seleccionado
7Implementar el flujo siguiendo exclusivamente la lista de verificación de la referencia seleccionada

Árbol de Decisión

El usuario pide Clerk en Android/Kotlin
    |
    +-- ¿Se detectó proyecto Expo/React Native?
    |     |
    |     +-- SÍ -> No usar esta habilidad
    |     |
    |     +-- NO -> Continuar
    |
    +-- ¿Se detectó UI de autenticación existente?
    |     |
    |     +-- Vistas predefinidas detectadas -> Cargar references/prebuilt.md
    |     |
    |     +-- Flujo personalizado detectado -> Cargar references/custom.md
    |     |
    |     +-- Nueva implementación -> Preguntar al desarrollador prebuilt/custom, luego cargar referencia correspondiente
    |
    +-- Asegurar clave publicable y ruta de inicialización del SDK
    |
    +-- Asegurar que los artefactos correctos de Android están instalados
    |
    +-- Verificar requisitos previos de la guía de inicio rápido en el proyecto
    |
    +-- Implementar usando la referencia del flujo seleccionado

Referencias de Flujo

Una vez conocido el tipo de flujo, cargar exactamente una:

No mezclar las dos referencias en una sola implementación a menos que el desarrollador lo solicite explícitamente.

Contrato de Interacción

Antes de cualquier edición de implementación, el agente debe tener ambos:

  • elección de flujo: prebuilt o custom
  • una clave publicable real de Clerk

Si falta cualquiera de los valores en la solicitud/contexto del usuario:

  • preguntar al usuario por el/los valor(es) faltante(s)
  • pausar y esperar la respuesta
  • no editar archivos ni instalar dependencias todavía

Solo omitir la pregunta cuando el usuario ya haya proporcionado explícitamente el valor en esta conversación.

Plantillas Basadas en Código Fuente

No codifiques ejemplos de implementación fijos en esta habilidad. Inspecciona las fuentes/documentación actuales de clerk-android para la versión instalada del SDK antes de implementar.

Caso de UsoFuente de Verdad
Artefactos del SDK y división de dependencias (clerk-android-api vs clerk-android-ui)README de clerk-android y documentos de instalación de Android
Inicialización del SDK y configuración de la clave publicableGuía de inicio rápido de Android y source/api/.../Clerk.kt
Comportamiento de autenticación y perfil predefinidossource/ui/.../AuthView.kt, source/ui/.../UserButton.kt y ejemplo predefinido
Secuenciación de autenticación personalizada y manejo de factoressource/ui/auth/*, source/api/auth/* y ejemplo de flujos personalizados
Control de capacidades/funcionalidades desde la configuración de la instanciaCampos públicos de Clerk (por ejemplo enabledFirstFactorAttributes, socialProviders, isGoogleOneTapEnabled, mfaIsEnabled) y modelo de entorno fuente
Lista de verificación de configuración requerida de AndroidGuía de inicio rápido oficial de Android (/docs/android/getting-started/quickstart)

Puertas de Ejecución (No Omitir)

  1. No editar implementación antes de los prerrequisitos

    • No editar archivos del proyecto hasta que el tipo de flujo esté confirmado y haya una clave publicable válida disponible.
  2. Flujo o clave faltantes deben generar una pregunta

    • Si falta la elección del flujo, preguntar explícitamente: ¿vistas predefinidas o flujo personalizado?
    • Si la clave publicable falta, es un marcador de posición o no es válida, preguntar explícitamente por una clave real.
    • No continuar hasta que ambas respuestas estén dadas.
  3. El modo de configuración de la clave publicable es obligatorio

    • Por defecto, conectar la clave proporcionada por el desarrollador directamente en Clerk.initialize(...).
    • No introducir indirección de gestión de secretos a menos que se solicite explícitamente.
  4. La política de instalación de artefactos es obligatoria

    • Flujo predefinido: usar clerk-android-ui (incluye API).
    • Flujo personalizado: usar clerk-android-api a menos que se soliciten explícitamente componentes predefinidos.
    • Si faltan artefactos de Clerk, agregar la última versión estable disponible.
  5. El cumplimiento de la guía de inicio rápido de Android es obligatorio

    • Verificar que la API nativa esté habilitada para la aplicación Clerk.
    • Verificar que los requisitos de Android de la guía de inicio rápido estén implementados en el proyecto (SDK mínimo y objetivo de Java, permiso de Internet en el manifiesto, inicialización de Clerk a nivel de aplicación).
    • Verificar que la aplicación espere la inicialización del SDK (Clerk.isInitialized) antes de asumir el estado listo para autenticación.
  6. El comportamiento basado en capacidades es obligatorio

    • Usar el estado de capacidades/configuración en tiempo de ejecución de Clerk (por ejemplo, factores habilitados/proveedores sociales/marcas MFA) para controlar el comportamiento del flujo.
    • No codificar suposiciones de factores que puedan entrar en conflicto con la configuración del panel de control.
  7. La disciplina del archivo de referencia es obligatoria

    • Una vez seleccionado el flujo, seguir solo ese archivo de referencia de flujo para la implementación y verificación.
  8. La paridad de estructura del flujo personalizado es obligatoria

    • Para el flujo custom, preservar la progresión de autenticación en varios pasos y el manejo específico de factores (sin un formulario único de todos los campos por defecto).
    • Mantener la UI, la orquestación de estado y la integración con la API de Clerk en módulos separados.
  9. La preferencia por el flujo predefinido es obligatoria cuando se selecciona

    • Para el flujo prebuilt, no reconstruir formularios de autenticación con llamadas API personalizadas a menos que se solicite explícitamente.
    • Usar AuthView/UserButton como bloques de construcción predeterminados.

Flujo de Trabajo

  1. Detectar Android nativo vs Expo/React Native.
  2. Si el tipo de flujo no está explícitamente proporcionado, preguntar al usuario por prebuilt o custom.
  3. Si la clave publicable no está explícitamente proporcionada, preguntar al usuario por ella.
  4. Esperar ambas respuestas antes de cambiar archivos.
  5. Cargar el archivo de referencia del flujo correspondiente.
  6. Asegurar que la ruta de Clerk.initialize(...) y la configuración de la clave publicable sean válidas.
  7. Asegurar que las dependencias/artefactos coincidan con el flujo seleccionado.
  8. Revisar los requisitos de la guía de inicio rápido de Android y aplicar la configuración faltante en el proyecto.
  9. Implementar usando la lista de verificación de la referencia seleccionada.
  10. Verificar usando la lista de verificación de la referencia seleccionada más las puertas compartidas.

Errores Comunes

NivelProblemaPrevención
CRÍTICONo preguntar por la elección del flujo faltante antes de la implementaciónPreguntar por prebuilt vs custom y esperar antes de editar
CRÍTICONo preguntar por la clave publicable faltante antes de la implementaciónPreguntar por la clave y esperar antes de editar
CRÍTICOEmpezar la implementación antes de confirmar el tipo de flujoConfirmar el flujo primero y cargar la referencia correspondiente
CRÍTICOOmitir los prerrequisitos de la guía de inicio rápido de AndroidVerificar y aplicar la configuración requerida de la guía de inicio rápido oficial de Android
CRÍTICOFalta la llamada a Clerk.initialize(...) a nivel de aplicaciónInicializar Clerk desde la ruta de inicio de Application
ALTOArtefacto incorrecto para el flujo elegidoPredefinido: clerk-android-ui; personalizado: clerk-android-api
ALTORenderizar la UI de autenticación antes de que se complete la inicialización del SDKProteger la UI con el estado Clerk.isInitialized
ALTOCodificar fijamente factores de autenticación/proveedores socialesGuiar el comportamiento desde los campos de capacidad en tiempo de ejecución de Clerk
ALTOUsar esta habilidad para Expo/React NativeDetectar y redirigir antes de la implementación

Ver También

  • Habilidad clerk para el enrutamiento general de Clerk
  • Habilidad clerk-setup para la configuración de inicio rápido entre marcos
  • 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

Skills relacionados