clerk-testing
E2E testing for Clerk apps. Use with Playwright or Cypress for auth flow tests
by clerkFree
Description
clerk-testing is an agent skill from the Clerk skills collection that helps a coding agent write end-to-end tests for applications that use Clerk authentication. It works with either Playwright or Cypress and covers auth flow tests, such as signing in and staying signed in across a test run. The skill's mental model is that each test needs a fresh authentication context, so auth state stays isolated between tests. It describes the setup in three parts: clerkSetup() initialises the test environment, setupClerkTestingToken() provides a testing token that gets past bot detection during test runs, and storageState lets Playwright keep the signed-in state between tests to make the suite faster. A decision tree helps the agent choose between Playwright and Cypress and point to the matching Clerk testing guide. The skill is listed on skills.sh, where the page shows install counts, the repository's GitHub stars and the results of its security audits.…
Highlights
- E2E tests for Clerk sign-in flows
- Works with Playwright or Cypress
- clerkSetup() for the test environment
- Testing token for bot detection during tests
- storageState to reuse sign-in between tests
- Decision tree for choosing a framework
Ratings & Reviews
No ratings yet
Be the first to rate clerk-testing.
People also visit
clerk-testing FAQ
What does this skill do?
It helps a coding agent write end-to-end tests for apps that use Clerk, with Playwright or Cypress, including auth flow tests.
How do I install it?
Run npx skills add https://github.com/clerk/skills --skill clerk-testing.
What is the testing token for?
The skill says setupClerkTestingToken() bypasses bot detection, so automated test runs can sign in.
Why is each test fresh?
The skill's model is that test auth is isolated session state, so each test needs its own fresh authentication context.
Can tests reuse a sign-in?
Yes. storageState persists authentication between tests, which the skill says speeds up the suite.
What are the security audit results?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best clerk-testing alternatives?
Popular alternatives to clerk-testing include e2e-testing-patterns, migrate and playwright-expert. See all clerk-testing alternatives