Menu
Use when running the manual regression test suite before merging a PR — covers setup, which sections to always run, known pre-existing failures to skip, and the PR checklist.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when adding a new MCP tool to Claude in Safari — covers the full workflow from spec through implementation, tests, manifest updates, and PR creation.
Use when the Claude in Safari extension stops working after a code change, build, or Safari restart — specifically when the extension is missing from "Web Extension Background Pages", flashes and disappears, disappears from Safari Settings entirely, or make health fails with timeout.
| name | regression-test |
| description | Use when running the manual regression test suite before merging a PR — covers setup, which sections to always run, known pre-existing failures to skip, and the PR checklist. |
Full test suite: docs/regression-tests.md. This skill covers what to run, what to skip, and how to confirm pass/fail.
make dev # build, launch, create dev.sock symlink
npm test && make test-swift # automated tests must pass first
Safari manual checks (cannot be automated):
These are fast and cover core infrastructure. Run for every PR:
| Section | What it covers |
|---|---|
| 1 | Automated test suite |
| 2 | Infrastructure (socket, tool registration) |
| 3 | Screenshot |
| 4 | Navigation |
| 5 | Page reading |
| 6 | Page interaction |
| Tool / Section | Symptom | Root cause |
|---|---|---|
Section 7 (javascript_tool) | "executeScript returned no result" | Safari MV2 doesn't await Promise return values from injected scripts — always null |
computer with read_page refs | "Element 'ref_N' not found" | accessibility-tree.js uses in-memory WeakRef map; computer.js needs data-claude-ref DOM attrs (set only by find.js). Must use find before computer(ref). |
file_upload on file:// pages | "No result from injected script" | Safari restricts executeScript on file:// pages. Use HTTP: python3 -m http.server 8765 --directory /tmp |
These are pre-existing bugs not introduced by the PR under test. Document them in the PR description but do not block merge.
Always run the section(s) for the feature being PR'd:
javascript_toolcomputer + findAt the end of docs/regression-tests.md there is a PR checklist. Copy it into the PR description before requesting review.
make send TOOL=<tool_name> ARGS='{"key": "value"}'
make send activates Safari automatically before each call. Use this, not mcp-test.py directly.