Agent skill

Clerk Testing

by geekskai in geekskai/blog

E2E testing for Clerk apps. An agent skill from geekskai/blog.

MITAuto-check passedTesting & QA

Install Clerk Testing

skills CLI
$ npx skills add geekskai/blog --skill clerk-testing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install geekskai/blog clerk-testing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/geekskai/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clerk-testing .claude/skills/clerk-testing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clerk-testing
GitHub stars
103
Used in
3 other repos
Token cost
~483 tokens
SKILL.md length
154 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

E2E testing for Clerk apps. An agent skill from geekskai/blog.

  • Works in 4 steps: Identify test framework (Playwright or… → WebFetch the appropriate URL from… → Follow official setup instructions → …
  • Tasks that involve End-to-end testing
  • SKILL.md covers Decision Tree, Mental Model, Workflow and Best Practices, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Clerk Testing is an agent skill from geekskai/blog. E2E testing for Clerk apps. Use with Playwright or Cypress for auth flow tests.

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires CLERKTESTINGTOKEN from Clerk dashboard

It sits in Testing & QA, covering End-to-end testing, Authentication and Browser testing. It works with Cypress and Playwright. The repository describes itself as: 🚀 2026 Most Popular FREE Blog Template! Next.js 14, Zero Code - Just Write & Deploy | 2026最火免费博客模板!支持Markdown,一键部署,极致性能!⚡️ ✨ Write in Markdown, get your professional blog in…. The licence is MIT.

When your agent uses it

  • Tasks that involve End-to-end testing
  • Tasks that involve Authentication
  • Tasks that involve Browser testing

Example prompts

  • “/clerk-testing”

Requirements

  • A credential in CLERK_TESTING_TOKEN
  • Compatibility (from SKILL.md): Requires CLERK_TESTING_TOKEN from Clerk dashboard
  • Pre-approved tools (allowed-tools): WebFetch

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Identify test framework (Playwright or Cypress)
  2. WebFetch the appropriate URL from decision tree above
  3. Follow official setup instructions
  4. Use pk_test_* and sk_test_* keys only

What it can do on your machine

Read from SKILL.md and the folder at commit e5554c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • WebFetch

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • clerk.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires CLERK_TESTING_TOKEN from Clerk dashboard

    From compatibility in the SKILL.md frontmatter.

Context cost

Clerk Testing loads about 483 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~483

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from geekskai/blog at commit e5554c5, republished under its MIT licence (© geekskai). 154 words, ~483 tokens.

Download SKILL.mdSave it as .claude/skills/clerk-testing/SKILL.md (or your agent's skills folder).
name
clerk-testing
description
E2E testing for Clerk apps. Use with Playwright or Cypress for auth flow tests.
allowed-tools
WebFetch
compatibility
Requires CLERK_TESTING_TOKEN from Clerk dashboard
license
MIT
metadata.author
clerk
metadata.version
1.2.0

Testing

Decision Tree

Mental Model

Test auth = isolated session state. Each test needs fresh auth context.

  • clerkSetup() initializes test environment
  • setupClerkTestingToken() bypasses bot detection
  • storageState persists auth between tests for speed

Workflow

  1. Identify test framework (Playwright or Cypress)
  2. WebFetch the appropriate URL from decision tree above
  3. Follow official setup instructions
  4. Use pk_test_* and sk_test_* keys only

Best Practices

  • Use setupClerkTestingToken() before navigating to auth pages
  • Use test API keys: pk_test_xxx, sk_test_xxx
  • Save auth state with storageState for faster tests
  • Use page.waitForSelector('[data-clerk-component]') for Clerk UI

Anti-Patterns

PatternProblemFix
Production keys in testsSecurity riskUse pk_test_* keys
No setupClerkTestingToken()Auth failsCall before navigation
UI-based sign-in every testSlow testsUse storageState

Framework-Specific

Playwright: Use globalSetup for auth state Cypress: Add addClerkCommands({ Cypress, cy }) to support file

See Also

  • clerk-setup - Install Clerk before adding tests
  • clerk-nextjs-patterns - Next.js patterns being tested
  • Demo Repo

© geekskai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/clerk-testing of geekskai/blog.

Open the folder on GitHubat commit e5554c5

Used in 3 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in geekskai/blog, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Clerk Testing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clerk Testing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clerk Testing this skillgeekskai/blog1033 repos~483Automated safety check: PassMIT
Open BrowserJasonHonKL/Openbrowser114—~1.6kAutomated safety check: PassMIT
Playwright Testingchongdashu/vibejam-starter-pack149—~2.1kAutomated safety check: PassNone
Playwright Login Flowsandrewyng/context-hub14k—~715Automated safety check: PassMIT
Bmad Testarch Frameworkbmad-code-org/bmad-method-test-architecture-enterprise1043 repos~1.2kAutomated safety check: PassCustom licence
Playwright E2E Testingfugazi/test-automation-skills-agents247—~3.2kAutomated safety check: PassMIT

Similar skills

  • Open Browser

    JasonHonKL/Openbrowser

    A skill your agent uses whenever the task involves browsing web pages, extracting page content, clicking forms, or completing web workflows.

    114 GitHub stars~1.6k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Playwright Testing

    chongdashu/vibejam-starter-pack

    Plan, implement, and debug frontend tests: unit/integration/E2E/visual/a11y.

    149 GitHub stars~2.1k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Playwright Login Flows

    andrewyng/context-hub

    Collects reusable Playwright patterns for logging in during end-to-end tests: password forms, OAuth redirects, saved browser state and TOTP two-factor codes.

    14k GitHub stars~715 tokensUpdated 4 mo ago
    Testing & QAAuto-check passed
  • Bmad Testarch Framework

    bmad-code-org/bmad-method-test-architecture-enterprise

    Initialize test framework with Playwright or Cypress. An agent skill from bmad-code-org/bmad-method-test-architecture-enterprise.

    104 GitHub starsUsed in 3 repos~1.2k tokens
    Testing & QAAuto-check passed
  • Playwright E2E Testing

    fugazi/test-automation-skills-agents

    Author and maintain versioned Playwright (@playwright/test) TypeScript UI specs for browser user flows.

    247 GitHub stars~3.2k tokensUpdated 5 days ago
    Testing & QAAuto-check passed
  • React Testing

    affaan-m/ECC

    React component testing with React Testing Library, Vitest/Jest, MSW for network mocking, accessibility assertions with axe, and the decision boundary between component tests and Playwright/Cypress…

    275k GitHub starsUsed in 1 repo~3.3k tokens
    Testing & QAAuto-check passed

More from geekskai/blog

All 20 skills in this repo
  • Clerk Android

    geekskai/blog

    Implement Clerk authentication for native Android apps using Kotlin and Jetpack Compose with clerk-android source-guided patterns.

    103 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • React SPA auth patterns with @clerk/react for Vite/CRA - ClerkProvider setup, useAuth/useUser/useClerk hooks, React Router protected routes, custom sign-in flows.

    103 GitHub starsUsed in 1 repo~1k tokens
    Auto-check: notes
  • React Router v7/v8 patterns with Clerk — rootAuthLoader, getAuth in loaders, clerkMiddleware, protected routes, SSR user data, org switching.

    103 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • TanStack React Start auth patterns with @clerk/tanstack-react-start - createServerFn, beforeLoad guards, loaders, Vinxi server.

    103 GitHub starsUsed in 1 repo~875 tokens
    Auto-check: notes
  • Astro patterns with Clerk — middleware, SSR pages, island components, API routes, static vs SSR rendering.

    103 GitHub stars~822 tokensUpdated yesterday
    Auto-check: notes
  • Clerk Billing

    geekskai/blog

    Clerk Billing for subscription management - render Clerk's PricingTable and in-app checkout drawer, configure subscription plans, seat-limit plans for B2B, feature entitlements with has(), and…

    103 GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Clerk Testing

What does Clerk Testing do?

E2E testing for Clerk apps. An agent skill from geekskai/blog. Clerk Testing is an agent skill from geekskai/blog. E2E testing for Clerk apps.

When should I use Clerk Testing?

Clerk Testing fits situations like: tasks that involve End-to-end testing; tasks that involve Authentication; tasks that involve Browser testing.

How do I install Clerk Testing in Claude Code?

Run `npx skills add geekskai/blog --skill clerk-testing -a claude-code`. Or copy the skill folder (.agents/skills/clerk-testing in geekskai/blog) into .claude/skills/clerk-testing in your project. Claude Code loads it when a task matches its description.

How do I install Clerk Testing in Codex?

Run `npx skills add geekskai/blog --skill clerk-testing -a codex`. Or copy the skill folder (.agents/skills/clerk-testing in geekskai/blog) into .agents/skills/clerk-testing in your project. Codex loads it when a task matches its description.

Can I use Clerk Testing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add geekskai/blog --skill clerk-testing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clerk-testing, .gemini/skills/clerk-testing, .github/skills/clerk-testing and .opencode/skills/clerk-testing in your project.

What does Clerk Testing need to run?

SKILL.md names no scripts, command-line tools or credentials: Clerk Testing is instructions for the agent only. Our summary lists: A credential in CLERK_TESTING_TOKEN. Its frontmatter pre-approves these tools: WebFetch. Compatibility (from SKILL.md): Requires CLERK_TESTING_TOKEN from Clerk dashboard.

Does Clerk Testing access the network?

SKILL.md names 2 domains. As links in the text: clerk.com and github.com. This is read from the text; nothing was executed.

Is Clerk Testing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clerk Testing use?

Clerk Testing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clerk Testing use?

About 483 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clerk Testing?

Skills that share tags, products or a category with Clerk Testing: Open Browser (JasonHonKL/Openbrowser, 114 stars), Playwright Testing (chongdashu/vibejam-starter-pack, 149 stars), Playwright Login Flows (andrewyng/context-hub, 14k stars) and Bmad Testarch Framework (bmad-code-org/bmad-method-test-architecture-enterprise, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clerk Testing?

geekskai (a GitHub user) maintains it in geekskai/blog, which has 103 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 7, 2026.

Source: geekskai/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.