# lighthouse-pagespeed-wasp-drone

lighthouse-pagespeed-wasp-drone is a subagent for Claude Code, Codex, and Cursor covering Lighthouse and PageSpeed Insights. It runs audits locally and in CI and explains score gaps.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/browser-and-app-testing-tools/agents/lighthouse-pagespeed-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/lighthouse-pagespeed-wasp-drone

## What it does

This subagent owns the measurement surface: Lighthouse runs via CLI, Node module, and DevTools, LHCI 0.15.x setup in GitHub Actions, interpreting the audit categories (Performance, Accessibility, Best Practices, SEO — the PWA category was dropped in Lighthouse 12), score budgets, and custom plugin authoring. It works from a companion skill, `lighthouse-pagespeed-stinger`, which indexes its guides.

The procedure is strict: throttling and form-factor are always set explicitly, at least three runs per measurement with the median reported, and lab numbers are reconciled against CrUX field data from the PSI API. One rule stands out — a clean TBT says nothing about INP, since INP covers the whole interaction lifecycle. Budgets are set off a measured baseline with a 10-20% buffer, never below production's current score without a fix plan.

Boundaries are explicit: SEO content work goes to `seo-aeo-wasp-drone`, Core Web Vitals fixes to `react-wasp-drone`, pipeline topology to `devops-wasp-drone`. Lighthouse plugins cannot use custom Gatherers, so page-specific data collection needs a full custom config instead.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install browser-and-app-testing-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/lighthouse-pagespeed-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/lighthouse-pagespeed-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/lighthouse-pagespeed-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/browser-and-app-testing-tools/agents/lighthouse-pagespeed-wasp-drone.md

## When to use it
- set up Lighthouse CI with LHCI in GitHub Actions
- add a performance budget gate to a CI pipeline
- reconcile a 90 Lighthouse score with failing field LCP or INP
- author a custom Lighthouse plugin
- pick a tracking tool: self-hosted LHCI server, Treo, or SpeedCurve

## Example prompts
- Set up Lighthouse CI for GitHub Actions in this repo
- Add a performance budget to CI so the build fails on regressions

## Similar
- [pagespeed-insights-mcp](https://affpapa.org/en/nevibecode/mcp/pagespeed-insights-mcp.md) — MCP server · ★ 83 repo stars
- [perf-lighthouse](https://affpapa.org/en/nevibecode/skills/perf-lighthouse.md) — skill · 341 installs
- [pagespeed-insights](https://affpapa.org/en/nevibecode/skills/pagespeed-insights.md) — skill · 1200 installs
- [lighthouse-runner](https://affpapa.org/en/nevibecode/plugins/lighthouse-runner.md) — plugin · ★ 2858 repo stars
- [web-perf](https://affpapa.org/en/nevibecode/skills/cloudflare-web-perf.md) — skill · 129400 installs
- [performance-and-web-vitals](https://affpapa.org/en/nevibecode/skills/performance-and-web-vitals.md) — skill · 1200 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
