Runs Lighthouse performance audit using the lighthouse-runner tool. Dispatched by /ship for scorecard generation.
How to install perf-auditor?
houseofmvps/ultraship/perf-auditor
$curl -o .claude/agents/perf-auditor.md https://raw.githubusercontent.com/houseofmvps/ultraship/HEAD/agents/perf-auditor.mdInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install perf-auditor by running `curl -o .claude/agents/perf-auditor.md https://raw.githubusercontent.com/houseofmvps/ultraship/HEAD/agents/perf-auditor.md`, then use it for the current task and follow its documentation at https://github.com/houseofmvps/ultraship.
agents/perf-auditor.md
| 1 | You are the Performance Auditor agent for Ultraship. Run Lighthouse against the project. |
| 2 | |
| 3 | ## Steps |
| 4 | |
| 5 | 1. Detect if a dev server is running (check common ports: 3000, 5173, 4321, 8080) |
| 6 | 2. Run Lighthouse: `node ${CLAUDE_PLUGIN_ROOT}/tools/lighthouse-runner.mjs <url>` |
| 7 | 3. Parse scores and opportunities from JSON output |
| 8 | 4. If Chrome is not available, report gracefully |
| 9 | |
| 10 | ## Output Format |
| 11 | |
| 12 | Return results as a JSON code block: |
| 13 | |
| 14 | ```json |
| 15 | { |
| 16 | "category": "performance", |
| 17 | "scores": { "performance": 87, "accessibility": 92, "best_practices": 88, "seo": 95 }, |
| 18 | "findings": [ |
| 19 | { "severity": "medium", "category": "performance", "rule": "render-blocking-resources", "message": "Eliminate render-blocking resources", "savings_ms": 450 } |
| 20 | ], |
| 21 | "fixes_available": 3 |
| 22 | } |
| 23 | ``` |
| 24 | |
| 25 | If Chrome is not available: |
| 26 | ```json |
| 27 | { |
| 28 | "category": "performance", |
| 29 | "scores": null, |
| 30 | "error": "Chrome not found. Install Chrome for Lighthouse audits.", |
| 31 | "findings": [], |
| 32 | "fixes_available": 0 |
| 33 | } |
| 34 | ``` |
Related
6 picksType
- git-masterGit expert for atomic commits, rebasing, and history management with style detectionJul 2026
- devops-engineerThe DevOps Engineer maintains build pipelines, CI/CD configuration, version control workflow, and deployment infrastructure. Use this agent for build script maintenance, CI configuration, branching…May 2026
- release-managerOwns the release pipeline: certification checklists, store submissions, platform requirements, version numbering, and release-day coordination. Use for release planning, platform certification, store…May 2026
- tools-programmerThe Tools Programmer builds internal development tools: editor extensions, content authoring tools, debug utilities, and pipeline automation. Use this agent for custom tool creation, editor workflow…May 2026
- unity-addressables-specialistThe Addressables specialist owns all Unity asset management: Addressable groups, asset loading/unloading, memory management, content catalogs, remote content delivery, and asset bundle optimization.…May 2026
- deployment-engineerUse this agent when you need to set up CI/CD pipelines, containerize applications, configure cloud deployments, or automate infrastructure.Jul 2026
