SKILL.md
Dogfood QA Testing — camofox-browser
Systematic exploratory testing of web applications using camofox-browser's anti-detection browser automation.
When to Use
- Testing web applications for bugs, UX issues, and accessibility problems
- QA validation before release
- Exploratory testing of new features
- Cross-browser verification with Firefox/Camoufox engine
Prerequisites
- camofox-browser server running on port 9377
- Target application URL accessible
Workflow
Phase 1: Initialize Session
# Create a dedicated test session
camofox open "about:blank" --user dogfood-qa
# Start trace recording for evidence capture
camofox trace start --user dogfood-qa --screenshots --snapshots
Phase 2: Navigate & Orient
# Navigate to target application
camofox navigate "https://target-app.com" --user dogfood-qa
# Take initial snapshot to understand page structure
camofox snapshot --user dogfood-qa
# Capture annotated screenshot for visual baseline
camofox annotate --user dogfood-qa
Phase 3: Systematic Exploration
3.1 Happy Path Testing
Follow the primary user flows:
# Interact with elements using refs from snapshot
camofox click e5 --user dogfood-qa
camofox type e3 "test input" --user dogfood-qa
camofox press Enter --user dogfood-qa
# Wait for navigation/loading
camofox wait networkidle --user dogfood-qa
# Capture state after each action
camofox snapshot --user dogfood-qa
3.2 Edge Case Testing
# Test empty inputs
camofox type e3 "" --user dogfood-qa
camofox press Enter --user dogfood-qa
# Test long strings
camofox type e3 "aaaa...very long string..." --user dogfood-qa
camofox press Enter --user dogfood-qa
# Test special characters
camofox type e3 "<script>alert('xss')</script>" --user dogfood-qa
camofox press Enter --user dogfood-qa
3.3 Error Discovery
# Check for console errors after interactions
camofox errors --user dogfood-qa
# Check console output for warnings
camofox console --user dogfood-qa --type warning
# Monitor all console messages
camofox console --user dogfood-qa --limit 50
3.4 State & Navigation Testing
# Test back/forward navigation
camofox go-back --user dogfood-qa
camofox go-forward --user dogfood-qa
# Save session state for later comparison
camofox session save dogfood-qa-state --user dogfood-qa
# Test page reload
camofox navigate "https://target-app.com" --user dogfood-qa
Phase 4: Document Issues
When a bug is found:
# 1. Capture visual evidence
camofox annotate --user dogfood-qa
# 2. Capture page errors
camofox errors --user dogfood-qa
# 3. Capture console logs
camofox console --user dogfood-qa
# 4. Mark trace chunk for this specific issue
camofox trace chunk-start --user dogfood-qa
# ... reproduce the bug ...
camofox trace chunk-stop --user dogfood-qa
# 5. Take snapshot for element state
camofox snapshot --user dogfood-qa
Phase 5: Wrap Up
# Stop trace recording
camofox trace stop --user dogfood-qa
# → Trace ZIP saved to ~/.camofox/traces/
# → View at https://trace.playwright.dev
# Final console/error summary
camofox errors --user dogfood-qa
camofox console --user dogfood-qa --type error
# Close session
camofox close --user dogfood-qa
Issue Reporting
Use the [issue taxonomy](references/issue-taxonomy.md) to classify findings. Use the [report template](templates/dogfood-report-template.md) to document each issue.
Key Differences from Standard Browser Testing
| Feature |
Standard |
camofox-browser |
| Detection |
Easily flagged as bot |
Anti-detection (C++ spoofing) |
| Browser |
Chrome/Chromium |
Firefox/Camoufox |
| Evidence |
Screenshots only |
Traces (screenshots + DOM + network) |
| Console |
Manual DevTools |
console / errors commands |
| Element refs |
CSS selectors |
Accessibility tree refs (eN) |
Tips
- Use
trace chunk-start/stop to isolate specific bug reproductions within a longer session
- Check
errors frequently — many bugs show console errors before visual symptoms
- Use
annotate for visual evidence — it numbers all interactive elements
- Trace ZIPs contain full reproduction data — share via trace.playwright.dev
- The
--user flag isolates test sessions from each other