# Pagespeed Diagnostics

> Run Portable Web Toolkit PageSpeed Insights diagnostics (Google PSI) for toolkit-managed sites. Use when measuring Core Web Vitals or PSI categories after deploy or during maintenance. Requires GOOGLE_PAGESPEED_API_KEY in the client .env.

- Skill: `imyourboyroy/pagespeed-diagnostics` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add imyourboyroy/pagespeed-diagnostics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/imyourboyroy/pagespeed-diagnostics/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: ImYourBoyRoy (https://skillmd.com/u/imyourboyroy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/imyourboyroy/pagespeed-diagnostics

---


# PageSpeed Diagnostics

Thin skill for Google PageSpeed Insights via the toolkit CLI.

## Prerequisites

- Client `.env` has `GOOGLE_PAGESPEED_API_KEY` (section A).
- `*.site-profile.json` and linked `Web_Toolkit/`.

## Commands

```bash
node ./Web_Toolkit/pagespeed_diagnostics/bin/pagespeed-diagnostics.mjs run \
  --site-profile ./<site>.site-profile.json --strategy both

# Agent-friendly batch / regression
node ./Web_Toolkit/pagespeed_diagnostics/bin/pagespeed-diagnostics.mjs agent-batch \
  --site-profile ./<site>.site-profile.json --routes core --strategy mobile
node ./Web_Toolkit/pagespeed_diagnostics/bin/pagespeed-diagnostics.mjs agent-diff \
  --site-profile ./<site>.site-profile.json
```

## Rules

1. Prefer measuring **after** remote cache warm (cold edge skews scores).
2. Summarize CWV + top opportunities; propose a minimal fix plan before editing.
3. 100/100/100/100 is a target — do not break brand, forms, or a11y chasing scores.