Agent skill · software engineering · jeremylongshore
clerk-ci-integration
Configure Clerk CI/CD integration with GitHub Actions and testing.
Why this skill is useful
Adds a complete CI/CD pipeline setup with Clerk authentication testing, including GitHub Actions workflows and Playwright scripts that are not commonly found in public documentation.
What it needs
Requires npm installed locally. Requires clerk, github account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Clerk CI Integration Overview Set up CI/CD pipelines with Clerk authentication testing. Covers GitHub Actions workflows, Playwright E2E tests with Clerk auth, test user management, and CI secrets configuration. Prerequisites GitHub repository with Actions enabled Clerk test API keys (pktest / sktest) npm/pnpm project configured Instructions Step 1: GitHub Actions Workflow Step 2: Configure GitHub Secrets Add these secrets in GitHub repo > Settings > Secrets: Secret Value -------- ------- CLERKPKTEST pktest... from dev instance CLERKSKTEST sktest... from dev instance CLERKWEBHOOKSECRETTEST whsec... from dev webhooks CLERKTESTUSEREMAIL ci-test@yourapp.com CLERKTESTUSERPASSWORD Strong test password Step 3: Playwright Auth Setup Step 4: Playwright Config with Auth State Step 5: E2E Test Examples Step 6: Test User Seed Script for CI Output GitHub Actions workflow with Clerk env vars from secrets Playwright auth setup saving session state for reuse E2E tests covering authenticated and unauthenticated flows Test user seed script for CI environments Protected API endpoint test Error Handling Error Cause Solution ------- ------- ---------- Secret not found in CI Missing GitHub secret Add in repo Settings > Secrets and variables > Actions Test user sign-in fails User not created or wrong password Run seed script, verify credentials Timeout on sign-in page Clerk SDK not loaded in CI build Ensure NEXTPUBLICCLERKPUBLISHABLEKEY is set E2E auth state stale Cached session expired Delete .auth/ directory, re-run setup Examples Vitest Unit Test with Mocked Clerk Resources Clerk Testing Guide Playwright Authentication GitHub Actions Secrets Next Steps Proceed to clerk-deploy-integration for deployment platform setup.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/clerk-ci-integration