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
.claude/agents/testcafe-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/testcafe-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/testcafe-expert.mdCursor also reads .claude/agents/
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