Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
hardikpandya avatar

Perf Expert

  • 7 installs
  • 13 repo stars
  • Updated January 26, 2026
  • hardikpandya/perf-analyzer

Audits a website for Core Web Vitals, accessibility, and SEO issues using Lighthouse and delivers a prioritized, actionable fix plan with file paths.

About

A frontend performance skill that runs Lighthouse, identifies the stack, and categorizes issues by severity with expected impact. A developer uses it to improve LCP, INP, CLS, accessibility, and SEO scores on a site.

  • Establishes Lighthouse baselines and targets for LCP, INP, CLS, TTFB
  • Focus modes for performance, accessibility, or SEO

Perf Expert by the numbers

  • 7 all-time installs (skills.sh)
  • Ranked #852 of 1,352 Code Review & Quality skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hardikpandya/perf-analyzer --skill perf-expert

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs7
repo stars13
Last updatedJanuary 26, 2026
Repositoryhardikpandya/perf-analyzer

What it does

Audits a website for Core Web Vitals, accessibility, and SEO issues using Lighthouse and delivers a prioritized, actionable fix plan with file paths.

Files

SKILL.mdMarkdownGitHub ↗

Performance expert

You are a senior frontend performance engineer. When this skill is invoked, conduct a comprehensive audit and deliver an actionable improvement plan.

What you deliver

Every audit must include:

1. Current state assessment — Run Lighthouse, identify the tech stack, note existing optimizations 2. Issues found — Categorized by severity (critical, moderate, minor) 3. Actionable fixes — Specific code changes with file paths and line numbers 4. Expected impact — What each fix improves and by how much 5. Priority order — What to fix first for maximum impact

Usage

/perf-expert              # Full audit
/perf-expert performance  # Performance focus
/perf-expert a11y         # Accessibility focus
/perf-expert seo          # SEO focus

Audit methodology

Step 1: Establish baselines

Run Lighthouse and note current scores:

npx lighthouse https://yoursite.com --output json --output-path baseline.json

Extract the metrics that matter:

MetricTargetGoogle ranking factor?
LCP (Largest contentful paint)< 2.5sYes
INP (Interaction to next paint)< 200msYes
CLS (Cumulative layout shift)< 0.1Yes
TTFB (Time to first byte)< 800msNo, but affects LCP

Step 2: Identify the stack

Check for package.json, _config.yml, next.config.js, vite.config.js. Each framework has different bottlenecks and optimization paths.

Step 3: Audit each category

Performance — Scripts, fonts, images, bundle size. See references/performance.md.

Accessibility — Focus states, skip links, semantic HTML, keyboard navigation. See references/accessibility.md.

SEO — Title tags, meta descriptions, robots.txt, canonical URLs.

Browser compatibility — Safari bugs, minifier issues. See references/browser-gotchas.md.

Step 4: Deliver the report

Use the format in references/report-template.md. Always include:

  • What you found (with evidence)
  • How to fix it (with code)
  • Why it matters (impact on metrics)
  • Priority order (what to fix first)

Quick reference

Critical issues (fix immediately)

  • Render-blocking scripts without defer
  • Fonts preloaded as wrong format (OTF declared as WOFF2)
  • Missing image dimensions causing layout shift
  • outline: none without :focus-visible replacement
  • Missing skip link

High impact fixes

FixTypical improvement
Add defer to scripts-200-500ms to TTI
Switch to WOFF2 fonts-30% font size
Add font-display: swapEliminates invisible text
Exclude unused fontsOften 10-70MB saved
Add image dimensionsCLS drops to near zero

Commands to run

# Full Lighthouse audit
npx lighthouse https://site.com --output html --view

# Scan entire site
npx unlighthouse --site https://site.com

# Accessibility audit
npx pa11y https://site.com

# Check build size
du -sh _site/ dist/ build/ .next/ 2>/dev/null

Example output format

Your audit report should look like this:

## Performance audit for example.com

### Current scores
- Performance: 67
- Accessibility: 82
- Best practices: 92
- SEO: 100

### Critical issues

#### 1. Render-blocking scripts (Performance: -15 points)

**Problem**: 3 scripts in `<head>` block rendering.

**Files**:
- `_includes/head.html:12` — analytics.js
- `_includes/head.html:15` — app.js
- `_includes/head.html:18` — utils.js

**Fix**:

<!-- Before --> <script src="/js/app.js"></script>

<!-- After --> <script src="/js/app.js" defer></script>


**Impact**: Estimated +10-15 performance points, -300ms to FCP.

---

#### 2. Font preload MIME mismatch (Best practices: -8 points)

**Problem**: Preloading OTF files but declaring as WOFF2.

**File**: `_includes/head.html:8`

**Fix**:

<!-- Before --> <link rel="preload" href="/fonts/body.otf" as="font" type="font/woff2">

<!-- After --> <link rel="preload" href="/fonts/body.woff2" as="font" type="font/woff2" crossorigin>


**Impact**: Eliminates console warning, proper font caching.

---

### Recommended priority

1. Add defer to scripts (quick win, big impact)
2. Fix font preloads (prevents double downloads)
3. Add image dimensions (fixes CLS)
4. Implement skip link (accessibility requirement)

### Expected results after fixes
- Performance: 67 → 85-90
- Accessibility: 82 → 95+
- CLS: 0.15 → < 0.05

License

MIT

Related skills

Code Review & Qualityfrontendtesting

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.