wp-theme-qalisted
Install: claude install-skill roama-studio/skills
# QA of a WordPress theme
The theme must work in WordPress AND survive what the client will do in
the admin: longer texts, more menu items, more or fewer cards, photos of
any size. The static site's checks (`qa-kit check`) do not run PHP - this
does.
## 1. Run the kit
```bash
./qa-kit wp . --theme wp-theme/<slug> --wp-cli "<slug> import" --round N
```
- It mounts a **copy** of the theme (the project's files are never
touched), installs `secure-custom-fields` and `contact-form-7` from
wordpress.org (`--plugins a,b` / `none` to change), runs the setup
commands, then measures. The first start downloads WordPress and the
plugins (2-5 min); a full run of ~8 pages takes ~5 min.
- `--pages a/,b/` adds pages the crawl does not find; `--php 8.2` /
`--wp 6.8` matches the client's host; `--no-stress` skips the second
pass; `--port` if 9400 is busy.
- It stops the server itself (`server_stopped: true` in the report). If a
run is killed, free the port before the next run.
- Output: `test-results/qa-kit/wp/round-N/wp-report.json`, `shots/`
(390 and 1440 of every page, plus any page/width with a finding) and
`shots/stress/`, `server.log`, `wp-log/debug.log`.
## 2. What the findings mean
| check | level | meaning |
|---|---|---|
| `php_syntax` | fail | a theme file does not parse |
| `php_fatal` / `php_parse` / `php_warning` (theme file) | fail | from debug.log of the whole run (pages, admin, stress) |
| `php_deprecated` / `php_notice` (theme) | warn | breaks on the n