better-auth-best-practices

better-auth-best-practices スキルの概要

better-auth-best-practices スキルは、Better Auth を正しく組み込むための実践的なセットアップガイドです。単に「auth を追加して」といった汎用プロンプトでは足りない場面で特に役立ちます。TypeScript アプリで Better Auth を使う開発者に向いており、初期設定、auth.ts の配置、環境変数、database adapter、ルート接続、migrations、sessions、プラグインを踏まえたセットアップまで、導入時に迷いやすいポイントを具体的に補えます。

このスキルが実際に得意なこと

better-auth-best-practices は、Better Auth の統合を無駄なミスを減らして進めたいときに使うスキルです。特に「アプリに Better Auth を入れて」といった曖昧な依頼を、必要なインストール手順、想定ファイル構成、検証チェックまで含んだ、より実装可能な導入プランに落とし込むのが得意です。

向いているユーザー

このスキルが合うのは、次のようなケースです。

• 新規または既存アプリに Better Auth を追加したい開発者
• auth.ts、adapters、sessions、plugins、env 設定を支援するエージェント
• 公式サンプルを見る前に、まずは安全な出発点を押さえたいチーム

特に、使うフレームワークや database はすでに決まっているものの、Better Auth の導入ルートを確実にしたい場合に有効です。

通常のプロンプトと何が違うのか

通常のプロンプトでもそれらしい auth コードは出せますが、Better Auth 特有の要点を落としがちです。better-auth-best-practices skill は、リポジトリに基づいた次のようなガイダンスを補います。

• BETTER_AUTH_SECRET や BETTER_AUTH_URL などの必須 env vars
• CLI が auth.ts を探す場所
• migration や schema generation コマンドをいつ実行すべきか
• plugin を追加・変更したあとに CLI を再実行する必要
• GET /api/auth/ok を使ったシンプルな導入後ヘルスチェック

そのため、幅広い「ログイン機能を作って」という依頼よりも、インストール判断やトラブルシュート用途で実用的です。

このスキルで置き換えられないもの

このスキルは Better Auth の最新ドキュメントそのものを置き換えるものではありません。リポジトリでも、最新のコード例や API 変更は https://better-auth.com/docs を確認するよう明示されています。このスキルはセットアップを速める補助と判断材料として使い、最終的なフレームワーク別の実装はドキュメントで照合する前提で使うのが適切です。

導入判断のポイント

実運用に近い Better Auth 導入手順を踏まえたガイダンスが欲しいなら、better-auth-best-practices を入れる価値があります。一方で、フレームワーク込みの完全な starter、production 向けの security review、あるいは Better Auth の初期統合を超えた高度な authorization 設計が必要なら、これだけでは不足します。

better-auth-best-practices スキルの使い方

better-auth-best-practices スキルをインストールする

インストールは次のコマンドです。

npx skills add https://github.com/better-auth/skills --skill best-practices

これで better-auth/skills リポジトリ内の better-auth-best-practices ガイダンスが追加されます。

まず確認すべきソース

このスキルはコンパクトです。最初に読むべきなのは次のファイルです。

• better-auth/best-practices/SKILL.md

このスキルフォルダには追加の references/、rules/、補助スクリプトがないため、実際に使える情報のほとんどはこの 1 ファイルにまとまっています。

想定されている最低限の導入前提を把握する

このスキルを呼び出す前に、少なくとも次の情報を揃えておくと有効です。

• framework または runtime
• database の選定と adapter
• email/password、OAuth、その両方のどれが必要か
• auth handler を置く想定 route path
• plugins が必要かどうか
• リポジトリ内で auth.ts をどこに置くか

これらがないと、出力はどうしても汎用的になりやすくなります。

Better Auth の基本ワークフローを起点にする

リポジトリでは、次のような素直な手順が提示されています。

1. npm install better-auth
2. BETTER_AUTH_SECRET と BETTER_AUTH_URL を設定する
3. database と config を含む auth.ts を作成する
4. フレームワーク側の route handler を作成する
5. npx @better-auth/cli@latest migrate を実行する
6. GET /api/auth/ok で確認する

プロンプトにこれらのチェックポイントが入っていない場合は、この順に沿って回答を組み立てるようモデルに求めると、実装しやすい出力になりやすいです。

構成に合った CLI コマンドを使う

このスキルは、見落としやすい重要な違いを明確にしています。

• 組み込み adapter フローなら npx @better-auth/cli@latest migrate
• Prisma または Drizzle の schema generation なら npx @better-auth/cli@latest generate

ここは重要です。単に「Better Auth CLI を実行して」では曖昧すぎます。Prisma や Drizzle を使うなら、その点をプロンプトに明記して、migrate ではなく generate を使うべき出力に誘導してください。

auth.ts の置き場所を明示する

Better Auth CLI は、auth.ts を次の場所から探します。

• ./
• ./lib
• ./utils
• ./src 以下のパス

プロジェクトで独自の配置を使っているなら、エージェントに --config を使うよう指示してください。ここは導入時の詰まりポイントになりやすく、コード自体は正しく見えても、CLI が config file を見つけられないことがあります。

環境変数の方針もプロンプトに含める

このスキルでは、次の 2 つの重要な変数が特に強調されています。

• BETTER_AUTH_SECRET
• BETTER_AUTH_URL

さらに、これらの env vars が設定されている場合は、config 側で baseURL や secret を重ねて定義しないほうがよい、という点にも触れています。これは重複や設定競合を避けるために大切です。より質の高い出力を得るには、次の点も添えると効果的です。

• ローカル環境と本番環境の base URL
• secret をどう