verdex-mcp: Skill for Claude Code

Verdex Playwright Complete Workflow

Complete test authoring in three phases: Explore → Select → Test

When to Use This Skill

Use this skill when you need to:

• Explore unfamiliar web applications and map user workflows
• Write stable, maintainable Playwright selectors that avoid positional .nth() selectors
• Create production-ready Playwright tests following best practices
• Understand complex UIs through progressive DOM exploration

The Complete Workflow

Phase 1: Explore & Map Workflows 🗺️

Goal: Understand the application and user journeys before writing any code

When to read the detailed guide: When starting work on a new application or feature

• Read guides/workflow-discovery.md for interactive exploration techniques
• Use Verdex MCP browser tools (browser_navigate, browser_click, browser_snapshot) with refs
• Document user journeys, state transitions, and assertion points
• Identify all interactive elements and their behaviors

Phase 2: Build Stable Selectors 🎯

Goal: Convert exploration discoveries into production-ready Playwright selectors

When to read the detailed guide: After workflow exploration, when you have refs and need selectors

• Read guides/selector-writing.md for comprehensive selector patterns
• Use the Container → Content → Role pattern
• Apply progressive DOM exploration (resolve_container, inspect_pattern, extract_anchors)
• Check uniqueness first—many elements need only simple selectors

Phase 3: Write Idiomatic Tests ✍️

Goal: Transform selectors and workflows into clean, maintainable Playwright tests

When to read the detailed guide: When you have selectors and workflows ready to code

• Read guides/playwright-patterns.md for test structure and patterns
• Follow Arrange-Act-Assert pattern
• Use Playwright's auto-waiting (avoid manual waits)
• Create independent, focused tests