Skip to content

secondsky/claude-skills / plugins/better-auth/skills/better-auth

better-auth

Verified

Skill for integrating Better Auth - comprehensive TypeScript authentication framework for Cloudflare D1, Next.js, Nuxt, and 15+ frameworks. Use when adding auth, encountering D1 adapter errors, or implementing OAuth/2FA/RBAC features.

FileKindSize
SKILL.mdskill md29.2 KB
assets/auth-flow-diagram.mdmarkdown24.0 KB
references/advanced-features.mdmarkdown14.7 KB
references/cloudflare-worker-drizzle.tsscript12.7 KB
references/cloudflare-worker-kysely.tsscript9.7 KB
references/configuration-guide.mdmarkdown10.7 KB
references/database-schema.tsscript10.8 KB
references/databases/mongodb.mdmarkdown5.3 KB
references/databases/mysql.mdmarkdown6.8 KB
references/databases/postgresql.mdmarkdown8.4 KB
references/error-catalog.mdmarkdown12.9 KB
references/framework-comparison.mdmarkdown8.2 KB
references/frameworks/api-frameworks.mdmarkdown9.2 KB
references/frameworks/expo-mobile.mdmarkdown8.7 KB
references/frameworks/nextjs.mdmarkdown5.4 KB
references/frameworks/nuxt.mdmarkdown6.0 KB
references/frameworks/remix.mdmarkdown6.1 KB
references/frameworks/sveltekit.mdmarkdown6.3 KB
references/integrations/electron.mdmarkdown8.2 KB
references/migration-guide-1.4.0.mdmarkdown23.2 KB
references/migration-guide-1.5.0.mdmarkdown6.3 KB
references/nextjs/README.mdmarkdown1.1 KB
references/nextjs/postgres-example.tsscript4.0 KB
references/plugins/api-tokens.mdmarkdown10.0 KB
references/plugins/authentication.mdmarkdown9.2 KB
references/plugins/enterprise.mdmarkdown9.1 KB
references/plugins/payments.mdmarkdown8.0 KB
references/plugins/sso.mdmarkdown9.4 KB
references/plugins/test-utils.mdmarkdown5.5 KB
references/react-client-hooks.tsxother12.8 KB
references/setup-guide.mdmarkdown8.9 KB
references/v1.4-features.mdmarkdown8.2 KB
references/v1.5-features.mdmarkdown11.0 KB
references/v1.6-features.mdmarkdown6.1 KB
scripts/generate-secret.shexecutablescript2.0 KB
scripts/setup-d1-drizzle.shexecutablescript10.2 KB
scripts/test-auth-health.shexecutablescript2.1 KB
scripts/validate-config.tsscript4.3 KB

scripts/test-auth-health.sh

View on GitHub
#!/bin/bash
# Test better-auth endpoints health
# Usage: ./test-auth-health.sh [base-url]

set -e

BASE_URL="${1:-http://localhost:8787}"
AUTH_PATH="/api/auth"

echo "Testing better-auth endpoints at: $BASE_URL$AUTH_PATH"
echo ""

# Test session endpoint
echo "1. Testing GET $AUTH_PATH/session..."
SESSION_RESPONSE=$(curl -s -w "\n%{http_code}" "$BASE_URL$AUTH_PATH/session" 2>/dev/null)
SESSION_CODE=$(echo "$SESSION_RESPONSE" | tail -n1)
if [ "$SESSION_CODE" = "200" ] || [ "$SESSION_CODE" = "401" ]; then
  echo "   Status: $SESSION_CODE (expected 200 or 401)"
else
  echo "   Status: $SESSION_CODE (unexpected - check your auth routes)"
fi

# Test sign-in endpoint exists
echo ""
echo "2. Testing POST $AUTH_PATH/sign-in/email (without body)..."
SIGNIN_RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "$BASE_URL$AUTH_PATH/sign-in/email" -H "Content-Type: application/json" -d '{}' 2>/dev/null)
SIGNIN_CODE=$(echo "$SIGNIN_RESPONSE" | tail -n1)
if [ "$SIGNIN_CODE" = "400" ] || [ "$SIGNIN_CODE" = "422" ]; then
  echo "   Status: $SIGNIN_CODE (expected - endpoint exists and validates)"
elif [ "$SIGNIN_CODE" = "404" ]; then
  echo "   Status: $SIGNIN_CODE (endpoint not found - check emailAndPassword config)"
else
  echo "   Status: $SIGNIN_CODE"
fi

# Test sign-up endpoint exists
echo ""
echo "3. Testing POST $AUTH_PATH/sign-up/email (without body)..."
SIGNUP_RESPONSE=$(curl -s -w "\n%{http_code}" -X POST "$BASE_URL$AUTH_PATH/sign-up/email" -H "Content-Type: application/json" -d '{}' 2>/dev/null)
SIGNUP_CODE=$(echo "$SIGNUP_RESPONSE" | tail -n1)
if [ "$SIGNUP_CODE" = "400" ] || [ "$SIGNUP_CODE" = "422" ]; then
  echo "   Status: $SIGNUP_CODE (expected - endpoint exists and validates)"
elif [ "$SIGNUP_CODE" = "404" ]; then
  echo "   Status: $SIGNUP_CODE (endpoint not found - check emailAndPassword config)"
else
  echo "   Status: $SIGNUP_CODE"
fi

echo ""
echo "Health check complete."
echo ""
echo "Next steps:"
echo "  - If endpoints return 404, verify your auth routes are mounted correctly"
echo "  - If using Cloudflare Workers, ensure D1 binding is configured"
echo "  - Check CORS if testing from browser"
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall