review-perf · git:20261116.0b1f268 · 2026-11-16 · sha256 5be7fedd656bd33c
review-perf git:20261116.0b1f268A
Immutable. This exact content never changes and is served at /api/v1/blob/5be7fedd656bd33c.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_bkephgybi7zbync2/5be7fedd656bd33c8409033ebffa938728a5a5a732693b2ffc6b174c5e6e658f.json
Then /plugin install review-perf@markdownregistry-bkephgybi7zbync2 in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: review-perf description: Performance review. Detects project type and dispatches compute and/or web performance reviewers. Advisory only — no changes made. model: opus --- # Performance Review Advisory-only performance review. Detects whether the project contains web content, non-web source code, or both, and dispatches the appropriate performance reviewer(s). No changes are made. ## Philosophy **Measure, don't guess.** Performance intuitions are unreliable. The reviewers identify structural issues and recommend what to measure, not just what to optimize. **Two domains, one workflow.** Compute performance (algorithms, memory, CPU) and web performance (network latency, caching, asset delivery) are fundamentally different disciplines. This skill dispatches the right specialist(s) for the project rather than applying one lens to everything. **Diagnostic, not therapeutic.** This skill identifies performance problems and recommends fixes. It does not implement them. Ask for changes directly after reviewing the findings, or use `/implement` with the review as context. ## Workflow Overview ``` ┌──────────────────────────────────────────────────────┐ │ PERFORMANCE REVIEW │ ├──────────────────────────────────────────────────────┤ │ 1. Detect project type (web, non-web, or both) │ │ 2. Determine scope │ │ 3. Dispatch performance reviewer(s) │ │ 4. Present consolidated report │ └──────────────────────────────────────────────────────┘ ``` ## Workflow Details ### 1. Detect Project Type Scan the project for source files to determine what performance domains apply. **Web indicators** (any of these → dispatch web reviewer): | Indicator | Signal | | ----------------------------------------------------------------------- | -------- | | `.html`, `.htm`, `.jsx`, `.tsx`, `.vue`, `.svelte` | Strong | | `package.json` with web framework (react, vue, next, nuxt, astro, etc.) | Strong | | `webpack.config.*`, `vite.config.*`, `next.config.*` | Strong | | `.css`, `.scss`, `.less` files (more than a few) | Moderate | | `_headers`, `_redirects`, `vercel.json`, `netlify.toml` | Moderate | | Service worker files (`sw.js`, `service-worker.js`) | Strong | **Non-web indicators** (any of these → dispatch compute reviewer): | Indicator | Signal | | ------------------------------------------------------------------------ | -------- | | `.go`, `.rs`, `.c`, `.cpp`, `.java`, `.py`, `.rb`, `.zig` source files | Strong | | Existing benchmarks (`*_bench*`, `Benchmark` in test files, `criterion`) | Strong | | Database query code (SQL files, ORM usage) | Moderate | | Data processing pipelines (ETL, batch processing) | Moderate | | CLI tool entry points | Moderate | **Full-stack projects** will have both indicators — dispatch both reviewers. **If neither is detected:** Report "No performance-relevant source code detected in this project." and abort. ### 2. Determine Scope Present detected project type and ask the user: ``` Detected project characteristics: - Web content: [Yes — N files / No] - Source code: [Yes — N files in Go, Python, etc. / No] Performance domains to review: - [x] Web performance (caching, assets, loading strategy) - [x] Compute performance (algorithms, memory, benchmarks) What should I review? - Both domains (default) - Web performance only - Compute performance only - Specific directory/scope ``` Accept the user's selection. Default: all applicable domains, entire project. ### 3. Dispatch Performance Reviewers Spawn the applicable reviewer(s) **in parallel**. **Web performance reviewer** (if web content detected and not excluded): Spawn a `swe-web-perf-reviewer` agent: ``` Review this project for web performance issues. Scope: [scope] Read all relevant files (HTML, CSS, JS, build configs, server configs) and perform your full audit: 1. Detect tooling and environment (build tools, monitoring, server config) 2. Audit across all categories: caching, asset delivery, critical path, resource loading, images, JavaScript cost, CSS efficiency, network overhead, Core Web Vitals risk factors 3. Classify every issue by severity (CRITICAL / HIGH / LOW) Produce your standard output format with summary, issues by severity, caching assessment, asset delivery assessment, and tooling recommendations. ``` **Compute performance reviewer** (if non-web source detected and not excluded): Spawn a `swe-perf-reviewer` agent: ``` Review this project for computational performance issues. Scope: [scope] Perform your full review: 1. Identify the hot paths — where work multiplies with input size or frequency — and establish n and the budget for each from the repo 2. Run the project's existing benchmarks or profilers on them, if any; otherwise cost them as labeled static estimates 3. Report paths that are too slow for their scale, and machinery that is over-provisioned for it 4. Recommend measurement infrastructure only where measuring would change a decision at the documented scale Produce your standard output format with findings organized by priority. ``` ### 4. Present Consolidated Report Collect all agent responses. Present a consolidated report: ``` ## Performance Review Scope: [what was reviewed] Domains reviewed: [Web / Compute / Both] ### Web Performance [web reviewer findings — or "Not applicable" if no web content] Issues: N (X critical, Y high, Z low) [merged findings by severity] --- ### Compute Performance [compute reviewer findings — or "Not applicable" if no non-web source] Issues: N (X critical, Y high, Z low) [merged findings by severity] --- ### Cross-Cutting Concerns [Your synthesis — issues that span both domains. For example: - Server-side rendering that is both a compute bottleneck and a web loading issue - API response times that are both an algorithmic problem and a network latency problem - Database queries that affect both backend throughput and frontend time-to-interactive If no cross-cutting concerns, omit this section.] ### Suggested Next Steps [Based on findings: - If critical/high issues found: recommend fixing them, noting which domain each belongs to - If no significant issues: "No significant performance issues found" - If missing tooling: recommend specific tools (Lighthouse, benchmarking frameworks, profiling tools)] ``` **The cross-cutting section is your synthesis.** Don't just concatenate the two reviewer outputs — look for issues that span both domains. ## Agent Coordination - Both reviewer agents run **in parallel** (they are read-only and independent) - Wait for all agents to complete before presenting the consolidated report - If an agent fails or times out, note the failure in the report and continue with other results ## Abort Conditions **Abort:** - Not a git repository - No source files detected in scope **Do NOT abort:** - Only one domain applies (run the applicable reviewer) - Missing performance tooling (reviewers will note this in their findings) - A single agent fails in a dual-agent dispatch (report failure, continue) - Few issues found (report "no significant issues" — that's a valid outcome)