Communitygithub.com

deangilmoreremix/videoremix.vip2

Kotlin と Jetpack Compose を使用したネイティブ Android アプリ向けに Clerk 認証を実装します。clerk-android のソースガイドパターンに従い、プリビルドの AuthView/UserButton またはカスタム API 駆動の認証フローを使用します。Expo や React Native プロジェクトには使用しないでください。

videoremix.vip2 とは?

このスキルは、ネイティブ Android プロジェクトに Clerk 認証を組み込むための包括的なガイダンスを提供します。Kotlin と Jetpack Compose を利用し、clerk-android SDK の最新パターンに従います。主に、プリビルドの AuthView/UserButton を使用する高速なセットアップと、カスタム API 駆動による完全制御可能な認証フローの 2 つのオプションをサポートします。Expo や React Native プロジェクトでは使用できず、それらが検出された場合は適切なスキルにルーティングされます。実装前にフローの種類(プリビルドまたはカスタム)と Clerk の発行可能キーの確認を必須とし、不足があればユーザーに問い合わせます。また、Android のクイックスタート要件、SDK の初期化、ランタイム機能に基づく動作制御など、厳格なチェックリストに従って実装を進めます。このスキルは、Claude Code や Cursor などの AI エージェントが Android アプリに Clerk 認証を追加する際の信頼できる手順書として機能します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Clerk Android (ネイティブ)

このスキルは、現在の clerk-android SDK とドキュメントのパターンに従って、ネイティブ Android プロジェクトに Clerk を実装します。

アクティベーションルール

以下のいずれかの条件が true の場合に、このスキルをアクティベートします。

  • ユーザーが明示的に Android、Kotlin、Jetpack Compose、または Android 上のネイティブモバイル Clerk 実装を要求した場合。
  • プロジェクトがネイティブ Android であるように見える場合 (例: build.gradle(.kts) に Android プラグイン、AndroidManifest.xml、app/src/main/java、Compose UI ファイルがあるなど)。

以下のいずれかの条件が true の場合は、このスキルをアクティベートしないでください。

  • プロジェクトが Expo である場合。
  • プロジェクトが React Native である場合。

Expo/React Native の兆候がある場合は、代わりに一般的なセットアップスキルにルーティングします。

必要なもの

タスク参照先
プリビルド AuthView / UserButton (最速)references/prebuilt.md
カスタム API 駆動の認証フロー (完全制御)references/custom.md

クイックスタート

ステップアクション
1プロジェクトタイプがネイティブ Android であり、Expo/React Native でないことを確認
2フローの種類 (prebuilt または custom) を決定し、対応する参照ファイルをロード
3実際の Clerk 発行可能キーが存在することを確認 (または開発者に依頼)
4選択したフローに適切な Clerk アーティファクトがインストールされていることを確認
5公式 Android クイックスタートを読み、必要なセットアップ (Native API、最小 SDK/Java、マニフェスト、初期化) を確認
6選択したフローに関連する clerk-android のソース/サンプルパターンを検査
7選択した参照チェックリストのみに従ってフローを実装

決定木

ユーザーが Android/Kotlin での Clerk を要求
    |
    +-- Expo/React Native プロジェクトが検出されたか?
    |     |
    |     +-- YES -> このスキルは使用しない
    |     |
    |     +-- NO -> 続行
    |
    +-- 既存の認証 UI が検出されたか?
    |     |
    |     +-- プリビルドビューが検出された -> references/prebuilt.md をロード
    |     |
    |     +-- カスタムフローが検出された -> references/custom.md をロード
    |     |
    |     +-- 新規実装 -> 開発者に prebuilt/custom を尋ね、一致する参照をロード
    |
    +-- 発行可能キーと SDK 初期化パスを確認
    |
    +-- 正しい Android アーティファクトがインストールされていることを確認
    |
    +-- プロジェクトでクイックスタートの前提条件を確認
    |
    +-- 選択したフロー参照を使用して実装

フロー参照

フローの種類が決まったら、正確に 1 つをロードします。

開発者が明示的にハイブリッドアプローチを要求しない限り、1 つの実装で 2 つの参照を混在させないでください。

インタラクション契約

実装の編集を行う前に、エージェントは以下の両方を保持している必要があります。

  • フローの選択: prebuilt または custom
  • 実際の Clerk 発行可能キー

ユーザーのリクエスト/コンテキストにいずれかの値が欠けている場合:

  • ユーザーに不足している値を尋ねる
  • 回答を待つために一時停止する
  • まだファイルを編集したり、依存関係をインストールしたりしない

ユーザーがこの会話で既に明示的に値を提供している場合にのみ、尋ねることをスキップします。

ソース駆動テンプレート

このスキルに実装例をハードコードしないでください。実装前に、インストールされた SDK バージョンの現在の clerk-android ソース/ドキュメントを検査してください。

ユースケース信頼できる情報源
SDK アーティファクトと依存関係の分割 (clerk-android-api vs clerk-android-ui)clerk-android README および Android インストールドキュメント
SDK の初期化と発行可能キーの配線Android クイックスタートおよび source/api/.../Clerk.kt
プリビルドの認証とプロファイルの動作source/ui/.../AuthView.kt、source/ui/.../UserButton.kt、およびプリビルドサンプル
カスタム認証のシーケンスとファクター処理source/ui/auth/*、source/api/auth/*、およびカスタムフローサンプル
インスタンス設定による機能/機能ゲーティングClerk の public フィールド (例: enabledFirstFactorAttributes、socialProviders、isGoogleOneTapEnabled、mfaIsEnabled) および環境モデルソース
必要な Android セットアップチェックリスト公式 Android クイックスタート (/docs/android/getting-started/quickstart)

実行ゲート (スキップ禁止)

  1. 前提条件を満たす前の実装編集禁止
  • フローの種類が確認され、有効な発行可能キーが利用可能になるまで、プロジェクトファイルを編集しないでください。
  1. フローまたはキーが欠けている場合は質問をトリガーする
  • フローの選択が欠けている場合は、明示的に「プリビルドビューとカスタムフロー」を尋ねます。
  • 発行可能キーが欠けている / プレースホルダー / 無効な場合は、明示的に実際のキーを要求します。
  • 両方の回答が提供されるまで続行しないでください。
  1. 発行可能キーの配線モードは必須
  • デフォルトでは、開発者が提供したキーを Clerk.initialize(...) に直接配線します。
  • 明示的に要求されない限り、シークレット管理の間接化を導入しないでください。
  1. アーティファクトインストールポリシーは必須
  • プリビルドフロー: clerk-android-ui を使用します (API を含む)。
  • カスタムフロー: プリビルドコンポーネントが明示的に要求されない限り、clerk-android-api を使用します。
  • Clerk アーティファクトが欠けている場合は、利用可能な最新の安定版リリースを追加します。
  1. Android クイックスタート準拠は必須
  • Clerk アプリで Native API が有効になっていることを確認します。
  • プロジェクトに Android クイックスタートの要件 (最小 SDK と Java ターゲット、マニフェストのインターネット権限、アプリレベルの Clerk 初期化) が実装されていることを確認します。
  • アプリが認証準備状態と見なす前に、SDK の初期化 (Clerk.isInitialized) を待つことを確認します。
  1. 機能駆動の動作は必須
  • Clerk のランタイム機能/設定状態 (例: 有効なファクター、ソーシャルプロバイダー、MFA フラグ) を使用してフローの動作をゲートします。
  • ダッシュボードの設定と競合する可能性のあるファクターの仮定をハードコードしないでください。
  1. 参照ファイルの規律は必須
  • フローが選択されたら、実装と検証のためにそのフロー参照ファイルのみに従います。
  1. カスタムフローの構造パリティは必須
  • custom フローの場合、マルチステップの認証進行とファクター固有の処理を維持します (デフォルトでは単一の全フィールドフォームにしない)。
  • UI、状態オーケストレーション、および Clerk API 統合を別々のモジュールに保持します。
  1. 選択された場合のプリビルド優先は必須
  • prebuilt フローの場合、明示的に要求されない限り、カスタム API 呼び出しで認証フォームを再構築しないでください。
  • デフォルトの構成要素として AuthView/UserButton を使用します。

ワークフロー

  1. ネイティブ Android と Expo/React Native を検出します。
  2. フローの種類が明示的に提供されていない場合は、ユーザーに prebuilt または custom を尋ねます。
  3. 発行可能キーが明示的に提供されていない場合は、ユーザーにそれを尋ねます。
  4. ファイルを変更する前に、両方の回答を待ちます。
  5. 一致するフロー参照ファイルをロードします。
  6. Clerk.initialize(...) のパスと発行可能キーの配線が有効であることを確認します。
  7. 依存関係/アーティファクトが選択したフローと一致することを確認します。
  8. Android クイックスタートの要件を確認し、プロジェクトに不足しているセットアップを適用します。
  9. 選択した参照チェックリストを使用して実装します。
  10. 選択した参照チェックリストと共有ゲートを使用して検証します。

よくある落とし穴

レベル問題防止策
CRITICAL実装前に不足しているフローの選択を尋ねないprebuilt vs custom を尋ね、編集前に待つ
CRITICAL実装前に不足している発行可能キーを尋ねないキーを尋ね、編集前に待つ
CRITICALフローの種類が確認される前に実装を開始する最初にフローを確認し、一致する参照をロードする
CRITICALAndroid クイックスタートの前提条件をスキップする公式 Android クイックスタートから必要なセットアップを確認し適用する
CRITICALアプリレベルの Clerk.initialize(...) 呼び出しがないApplication の起動パスから Clerk を初期化する
HIGH選択したフローに間違ったアーティファクトプリビルド: clerk-android-ui; カスタム: clerk-android-api
HIGHSDK 初期化が完了する前に認証 UI をレンダリングするClerk.isInitialized 状態で UI をゲートする
HIGH認証ファクター/ソーシャルプロバイダーをハードコードするClerk ランタイム機能フィールドから動作を駆動する
HIGHこのスキルを Expo/React Native に使用する実装前に検出してルーティングする

関連情報

  • 最上位の Clerk ルーティング用の clerk スキル
  • クロスフレームワークのクイックスタートセットアップ用の clerk-setup スキル
  • 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

関連スキル