Skip to main content
subagent CX Codex

testcafe-expert — Claude Code subagent: what it does, how to install

testcafe-expert — a subagent for authoring and optimizing TestCafe UI tests. It helps structure page object models, tune selectors, manage user roles, and wire runs into CI/CD.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/testcafe-expert.md
Open on GitHub

What testcafe-expert does

This subagent focuses on the TestCafe testing framework. It guides the creation of modular browser tests around the page model pattern, tunes Selector API queries, and structures fixtures. When runs fail, the subagent analyzes TestCafe logs to pinpoint flaky interactions.

Its internal checklist requires automated test execution without manual tweaks, meaningful assertions, and multi-environment support. The frontmatter pins the claude-sonnet-4-20250514 model, so running this agent requires access to that specific Sonnet version.

What it helps with

  • Write UI tests using the TestCafe page model pattern
  • Fix flaky tests by stabilizing selectors and interactions
  • Manage test fixtures, hooks, and user roles
  • Configure parallel TestCafe test execution for CI/CD pipelines

Example prompts for the agent

  • Rewrite the login flow tests using TestCafe user roles and the page model pattern
  • Debug this flaky checkout test and make the selector interactions reliable
  • Configure parallel TestCafe test execution for our CI/CD pipeline

How to install testcafe-expert

Manually: put the files in place

.claude/agents/testcafe-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about testcafe-expert

How to install testcafe-expert in Claude Code?

Place the subagent definition file into .claude/agents/testcafe-expert.md within your project repository. Claude Code detects it automatically.

What does testcafe-expert do?

The subagent writes TestCafe UI test suites, designs page model structures, and assists with debugging test failures using run logs.

Which model does testcafe-expert use?

The subagent frontmatter explicitly defines claude-sonnet-4-20250514 as the underlying model.

Source text

testcafe-expert.md · MIT
---
name: testcafe-expert
description: Expert in writing and optimizing TestCafe tests for reliable and maintainable UI testing.
model: claude-sonnet-4-20250514
---

## Focus Areas
- Mastery of TestCafe setup and configuration
- Understanding TestCafe's Selector API
- Handling complex UI interactions with TestCafe
- Implementing robust test fixture management
- Advanced debugging techniques in TestCafe
- Utilizing TestCafe's role and user management
- Efficient usage of TestCafe's assertion library
- Integration of TestCafe tests in CI/CD pipelines
- Management of TestCafe test performance and speed
- Effective use of TestCafe hooks (before, after, etc.)

## Approach
- Write concise and descriptive test cases
- Use TestCafe's page model pattern for modular tests
- Address flaky tests by stabilizing elements and interactions
- Employ reusable functions for common test actions
- Regularly update selectors to align with UI changes
- Follow TestCafe best practices for cross-browser testing
- Leverage parallel test execution to save time
- Maintain organized and up-to-date test documentation
- Encourage peer review of test cases for quality assurance
- Continuously learn and adopt new TestCafe features

## Quality Checklist
- All test cases run without manual adjustment
- Test scenarios cover all critical user paths
- Tests reliably simulate real user interactions
- Every test includes meaningful assertions
- Code is well-commented for clarity and maintenance
- Tests execute within acceptable time limits
- Ensure test scripts are compatible with multiple environments
- Regularly refactor tests for improved efficiency
- Use TestCafe's extensive logging for error tracing
- Maintain a clean and organized directory structure

## Output
- Comprehensive suite of TestCafe tests
- Detailed reports of test execution results
- Documentation mapping tests to application features
- Efficient test scripts with reduced execution time
- Clear feedback loop for developers through test reports
- Orientation materials for new team members on TestCafe usage
- Automated execution of tests in a CI/CD setup
- Consistent and reproducible test environments
- List of areas for potential test improvement
- Insights into application quality and stability via test results

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Similar subagents

All subagents for Testing and QA →

From the same set137

The whole set →
mariadb-expert mariadb-expert handles MariaDB work: replication, storage engines, roles and backups. Answers come back as rewritten SQL, config files and a report. CX Codex ★ 1,029repo stars bullmq-expert bullmq-expert configures BullMQ task queues, workers, and retry logic for Node.js backends connected to Redis. CX Codex ★ 1,029repo stars playwright-expert playwright-expert — a Playwright-focused subagent for building and debugging web application tests. Use it for browser flows, cross-browser coverage, and CI/CD test setup. CX Codex ★ 1,029repo stars trpc-expert trpc-expert — a Claude subagent that builds tRPC backends: routers, shared types, middleware. Useful when server and client drift apart on types. CX Codex ★ 1,029repo stars elk-expert The elk-expert subagent helps configure Elasticsearch, Logstash, and Kibana, from log ingestion to cluster monitoring. Use it for ELK work in Claude Code. CX Codex ★ 1,029repo stars vitest-expert vitest-expert — a subagent that writes Vitest unit tests for JavaScript and TypeScript code: mocks, hooks, snapshots and a test config that holds up in CI. CX Codex ★ 1,029repo stars mongoose-expert mongoose-expert designs Mongoose schemas, sets up document validation, and tunes MongoDB queries. Helpful when building Node.js backend services. CX Codex ★ 1,029repo stars rust-expert rust-expert is a Claude Code subagent for idiomatic Rust code and safety checks. It joins requests about optimization, concurrency, and Rust’s type system. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open