Agent Skills › midudev/autoskills › clerk-testing

clerk-testing

GitHub

提供Clerk应用端到端测试指南，支持Playwright和Cypress。涵盖环境初始化、测试Token配置、状态持久化及最佳实践，确保认证流程测试高效安全。

packages/autoskills/skills-registry/clerk-testing/SKILL.md midudev/autoskills

触发场景

需要进行Clerk应用的E2E测试询问Playwright或Cypress集成Clerk的方法设置Clerk测试环境

安装

npx skills add midudev/autoskills --skill clerk-testing -g -y

更多选项

非标准路径

npx skills add https://github.com/midudev/autoskills/tree/main/packages/autoskills/skills-registry/clerk-testing -g -y

不安装直接使用

npx skills use midudev/autoskills@clerk-testing

指定 Agent (Claude Code)

npx skills add midudev/autoskills --skill clerk-testing -a claude-code -g -y

安装 repo 全部 skill

npx skills add midudev/autoskills --all -g -y

预览 repo 内 skill

npx skills add midudev/autoskills --list

SKILL.md

Frontmatter

{
    "name": "clerk-testing",
    "license": "MIT",
    "metadata": {
        "author": "clerk",
        "version": "1.2.0"
    },
    "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"
}

Testing

Decision Tree

Framework	Documentation
Overview	https://clerk.com/docs/guides/development/testing/overview
Playwright	https://clerk.com/docs/guides/development/testing/playwright/overview
Cypress	https://clerk.com/docs/guides/development/testing/cypress/overview

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

Identify test framework (Playwright or Cypress)
WebFetch the appropriate URL from decision tree above
Follow official setup instructions
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

Pattern	Problem	Fix
Production keys in tests	Security risk	Use `pk_test_*` keys
No `setupClerkTestingToken()`	Auth fails	Call before navigation
UI-based sign-in every test	Slow tests	Use `storageState`

Framework-Specific

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

clerk-testing

clerk-testing

触发场景

安装

SKILL.md

Testing

Decision Tree

Mental Model

Workflow

Best Practices

Anti-Patterns

Framework-Specific

See Also

版本历史

同 Skill 集合

元信息

文库