インストール
npx skills add clerk/skills誰向けか
コーディング Agent で Clerk 認証をよりスムーズに扱いたいとき、とくに新規プロジェクトや任意のフレームワークへ Clerk を足す場合、あるいはユーザー、組織、アプリ、環境鍵、デプロイを確認する場合に、このスキル一式を使う。スキルは Agent Skills 形式に従い、コードベースへ Clerk を繋ぎつつ、Agent に先に正しいスキルを選ばせてから手を動かしたい開発者向け。公式は /clerk をルーターとし、常にここから始めると書いている。最初から子スキルを指名しないこと。開始前に Clerk Dashboard を開け、環境ファイルへ書ける鍵を入手できる必要がある。それが無いと、以降の導入と確認は鍵不足で止まる。
3 分で最初の試行を終える
公式リポジトリが示すインストールコマンドだけを使う：
npx skills add clerk/skills
入れたあとは先に鍵を用意する。プレースホルダで数を合わせない。Clerk Dashboard を開き、公開可能鍵とシークレット鍵をコピーし、プロジェクトの .env に書く。鍵名は必ず NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY と CLERK_SECRET_KEY。書く前に Agent にこの二つの鍵名と対象ファイルだけを復唱させ、確認してからファイル変更を許す。
最初のタスクは可逆の確認を選び、フレームワーク変更にはしない。スキルを読み込み済みのクライアントで /clerk と入力し、デプロイ確認または環境鍵の照合をしたいと伝え、ルーターに clerk-cli へ連れて行かせる。コマンドを実行する前に、呼び出すのは CLI 確認であり、ユーザー新規作成や組織変更はしないと Agent に言わせる。確認してから実行する。
成功の合図：Agent が /clerk から clerk-cli に入り、環境鍵またはデプロイ確認の結果を返す。スキル不足や鍵不足を返さない。Codex を使う場合、公式には別のマーケット追加コマンドがある。追加後は再起動し、/plugins を開き、Clerk Skills を選び、clerk-skills を入れて有効化し、新しいスレッドを開く。これは Codex 専用手順であり、デフォルトのインストールだと思わないこと。
利用事例
事例一：新規プロジェクトまたは任意フレームワークへの導入。公式スキル clerk-setup の役割は、任意のフレームワークへ Clerk を足すこと。新規プロジェクトとフレームワーク初期化に使える。手順は先に /clerk、いまのフレームワークと「Clerk 導入だけを足す」と伝え、ルーターを clerk-setup に着地させる。この種の作業はプロジェクトファイルを変える。Agent に変更予定ファイルを列挙させ、確認してから書く。説明には具体的なフレームワーク一覧も段階的パッチも無い。フレームワークの詳細はインストール後のスキル説明に従う。
事例二：CLI で読み取り専用の運用確認。clerk-cli はユーザー、組織、アプリ、環境鍵、デプロイ確認をカバーする。鍵を .env に書いたあと、既存アプリがデプロイできるか、鍵が揃っているか、あるいはユーザーと組織を読み取り専用で見るのに向く。同じく先に /clerk、それから clerk-cli。説明は具体的な CLI サブコマンドを列挙していないので、コマンド名を作らない。確認できるのは上記の確認種別であり、出力形式は実際の実行に従う。
利用上の境界
Dashboard の鍵が無ければ導入を始めない。環境ファイルは公式が書いた二つの鍵名だけを使う。未記載の変数名に変えない。デフォルトのインストールは npx skills add clerk/skills。Codex マーケットのインストールは Codex にだけ当てはまり、公式の順で clerk-skills を有効化する必要がある。常に /clerk から始める。ページは他の入口をルーター省略可能とは書いていない。公式はクライアントの完全な名簿を出していない。Codex の例から独占対応だと推測せず、ページの例から言語範囲も推測しない。書いていないスキルディレクトリ、マーケットコマンド、鍵の見本は補わない。リポジトリページ：
https://github.com/clerk/skills
Dashboard：
https://dashboard.clerk.com/