perf-auditlisted
Install: claude install-skill markbaindesign/bain-studio
# Performance Audit
Run a performance audit against a live site and save a prioritised fix report.
## Steps
### 1. Identify URL and pages
Use the URL from the invocation argument. If no URL is given, read `CLAUDE.md` for a `PROJECT_URL` or site URL.
Default to the homepage plus up to 4 key pages from the project. For WordPress sites, typical pages: `/`, `/services/`, `/contact/`, a representative content page.
If `--pages` is passed explicitly, use those paths as-is.
### 2. Determine output path
```
context/perf/perf-audit-{YYYY-MM-DD}.md
```
in the current project directory.
### 3. Run the audit script
```bash
python3 /media/data/dev/bain-studio/studio/perf_audit.py {BASE_URL} \
--pages {COMMA_SEPARATED_PATHS} \
--output {OUTPUT_PATH} \
--api-key $(grep GOOGLE_API_KEY /media/data/dev/bain-studio/studio/.env | cut -d= -f2)
```
The script runs PSI mobile + desktop per page. Allow 2-3 minutes for 3-4 pages. Do not interrupt.
For a single device:
```bash
# Mobile only
python3 /media/data/dev/bain-studio/studio/perf_audit.py {BASE_URL} --mobile-only ...
# Desktop only
python3 /media/data/dev/bain-studio/studio/perf_audit.py {BASE_URL} --desktop-only ...
```
### 4. Read and summarise
Once the report is saved, read it and present a summary:
- Overall performance scores (mobile / desktop) for each page
- Core Web Vitals: flag any POOR or NEEDS IMPROVEMENT ratings
- P1 fixes: list every P1 item with its estimated saving
- P2 fixes: list with savings
- P3/P4: me