CWV Superpowers: Geautomatiseerde Core Web Vitals-diagnose

Een gratis Claude Code-skill die koppelt met je CoreDash-field data en Chrome om LCP-, INP- en CLS-problemen te diagnosticeren en codefixes te genereren.

Arjen Karel
Bijgewerkt · 5 min lezen
Delen

CWV Superpowers in het kort

CWV Superpowers is een gratis open-source Claude Code-skill die koppelt met je CoreDash-field data en Chrome-browsertools om Core Web Vitals-problemen te diagnosticeren. De skill vindt je grootste knelpunt in echte gebruikersdata, achterhaalt de root cause en genereert de codefix.

Geen lijst met Lighthouse-suggesties. Het element, het bestand, de regel code.

Quickstart:

De code staat op GitHub. Installeer hem in Claude Code met twee commando's:

/* Installeer de MarketPlace en de CWV SuperPower Skill */
/plugin marketplace add corewebvitals/cwv-superpowers
/plugin install cwv-superpowers@cwv-superpowers

/* start nu de Core Web Vitals AI superpower*/
Waarom is mijn site traag?

Voeg daarna CoreDash toe als MCP-server en draai claude --chrome. Dat is alles.

Wat de CWV SuperPower-skill doet

CWV Superpowers combineert twee databronnen die samen antwoord geven op zowel wat er traag is als waarom.

CoreDash Real User Monitoring vertelt je wat er echt traag is. Echte gebruikers, echte apparaten, echte netwerken. CoreDash meet elke paginalading en koppelt elke metriek aan het exacte element dat het probleem veroorzaakt. Geeft CoreDash aan dat je LCP 4,2 seconden is en het bottleneck-element div.hero > img.main is, dan is dat wat je echte gebruikers ervaren.

Chrome-browsertracing vertelt je waarom. De skill bezoekt de pagina met mobiele emulatie (4G, 4x CPU-throttling), registreert de network waterfall en tracet precies de fasen die uit de RUM-data kwamen. Niet alles, alleen het deel waarvan bewezen is dat het je pagina's traag maakt!

Dat is de truc! RUM-data vertelt je wat er traag is, maar niet waarom. Een Chrome-trace geeft je het waarom, maar zonder field data onderzoek je de verkeerde pagina of de verkeerde metriek. CWV Superpowers combineert beide.

De skill diagnosticeert alle drie de Core Web Vitals: LCP (uitsplitsing in vier fasen), INP (uitsplitsing in drie fasen met scriptattributie) en CLS (patroonherkenning op basis van bekende oorzaken). Zie voor de volledige metriekspecifieke workflows de LCP-diagnosegids en INP-diagnosegids.

De workflow in 5 stappen

Elk onderzoek volgt vijf stappen.

Stap 1: Intentie. Je geeft aan waar de skill naar moet kijken ("LCP op mijn productpagina's") of vraagt hem het probleem te zoeken ("Wat moet ik als eerste fixen?"). Noem je iets specifieks, dan bakent hij de scope af. Wil je discovery, dan gaat hij door naar Stap 2.

Stap 2: Discovery. De skill scant je site via CoreDash. Hij haalt de algehele status op, de mobiele status, de slechtste URL's op LCP en de slechtste op INP. Daarna kiest hij het grootste probleem: 'slecht' gaat boven 'verbetering nodig', mobiel boven desktop, en hoger verkeersvolume weegt zwaarder. Een pagina met een p75-LCP van 2,4 seconden die 'slaagt' maar waarbij 18% van de gebruikers in de categorie 'slecht' valt, is nog steeds een probleem. CWV Superpowers signaleert dat.

Stap 3: Diagnose. Voor LCP doet de skill 5 tot 7 CoreDash API-calls: het LCP-element, het elementtype, de prioriteitsstatus, de uitsplitsing in vier fasen (TTFB, laadvertraging, laadtijd, rendervertraging) en de trend over 7 dagen. Hij wijst het knelpunt aan via proportioneel redeneren: de fase die het grootste deel van de totale tijd opslokt, niet de fase die een absolute drempelwaarde overschrijdt. Voor INP haalt hij het trage interactie-element, de LOAF-scripts en de uitsplitsing in drie fasen op. Voor CLS matcht hij met vijf bekende patronen.

Stap 4: Chrome-trace. Is Chrome beschikbaar, dan bezoekt de skill de pagina en tracet alleen de knelpuntfase uit Stap 3. Een gerichte trace levert bewijs. Een volledige trace van alles geeft ruis.

Stap 5: Output. Voer de codefix door, genereer een HTML-rapport, of allebei. De fix noemt het bestand, de regel en het element, en toont voor en na.

Hoe de output eruitziet

De skill genereert een root cause-analyse die field data, Chrome-bewijs en de specifieke fix aan elkaar koppelt:

Root cause: De LCP-afbeelding div.hero-banner > img.product-main op /product/running-shoes-42 wordt 1.980 ms te laat ontdekt omdat een preload hint ontbreekt en hij geen fetchpriority="high" heeft. CoreDash-data: LCP is 3.820 ms (slecht) op mobiel, p75. Laadvertraging is het knelpunt met 52% van het totaal. De Chrome-trace bevestigt: een gat van 1.940 ms tussen de first byte van de HTML en het request voor de afbeelding in de waterfall.

De fix volgt direct: voeg een preload hint toe, stel fetchpriority="high" in. Specifiek voor het element, het bestand en de oorzaak. Geen generiek advies.

Volledige rapporten bevatten metric-cards met kleurcodes, grafieken met de fasen-uitsplitsing, en is Chrome gebruikt: filmstrip-screenshots en een SVG van de network waterfall. Beide rapporttypes zijn op zichzelf staande HTML-bestanden die je zo in een Slack-thread dropt of aan een ticket hangt.

Tip: Chrome is optioneel. Zonder Chrome krijg je nog steeds een volledige RUM-diagnose, identificatie van knelpunten en codefixes. Je mist de visuals van de filmstrip en de waterfall, maar de kwaliteit van de diagnose is gelijk: data van echte gebruikers blijft de primaire bron van waarheid.

Aan de slag

Je hebt een CoreDash-account nodig waar data van echte gebruikers binnenstroomt. De gratis tier volstaat. Voor interactief gebruik heb je helemaal geen API-key nodig: Claude Code logt in via de browser. Wil je toch een key (voor headless of CI-runs), haal die dan op via Project Settings > API Keys (MCP). Keys worden eenmalig getoond, opgeslagen als SHA-256-hash en zijn read-only.

Claude Code (aanbevolen)

# Voeg de CoreDash MCP-server toe (browserlogin, geen API-key)
claude mcp add --transport http coredash https://app.coredash.app/api/mcp

# Voeg de skill toe vanuit de marketplace
/plugin marketplace add corewebvitals/cwv-superpowers
/plugin install cwv-superpowers@cwv-superpower

# Start met Chrome voor een volledige analyse
claude --chrome

Draai bij de eerste verbinding /mcp, kies coredash en selecteer Authenticate. Je browser opent de inlog- en toestemmingspagina van CoreDash; log in, kies een project en accepteer. Claude Code slaat een kortlevend OAuth-token op dat zichzelf ververst (toegang van 1 uur, refresh na 30 dagen) en altijd ingetrokken kan worden. Vraag daarna: "Wat zijn mijn Core Web Vitals?" Geeft hij je echte LCP-, INP- en CLS-data terug, dan ben je er klaar voor.

Gebruik je liever een API-key, of draai je headless zonder browser? Geef dan de Bearer-header mee:

claude mcp add --transport http coredash https://app.coredash.app/api/mcp \
  --header "Authorization: Bearer cdk_YOUR_API_KEY"

Cursor

Voeg CoreDash toe aan .cursor/mcp.json:

{
  "mcpServers": {
    "coredash": {
      "url": "https://app.coredash.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cdk_YOUR_API_KEY"
      }
    }
  }
}

Andere MCP-clients

De CoreDash MCP-server werkt met elke client die HTTP MCP ondersteunt: VS Code (Copilot agent-modus), Windsurf, Gemini CLI, Cline en JetBrains-IDE's. Het endpoint is https://app.coredash.app/api/mcp met een Bearer token-header. Zie de setupgids op GitHub voor de configuratie per client.

Lees het overzichtsartikel voor achtergrondinformatie over waarom field data cruciaal is voor Core Web Vitals-werk door AI-agents en waarom Lighthouse-only agents fixes opleveren die in een derde van de gevallen worden afgewezen.

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Een snellere site nodig?

Ik ben Arjen en ik maak al 17 jaar trage sites snel. Loop je tegen iets aan dat je zelf niet opgelost krijgt? Stuur me je URL, dan praten we even.

Stuur me je URL
Arjen Karel
Arjen Karel, Web performance consultant sinds 2009

Waarom werkt onze fix niet?

Soms serveert het CDN nog de oude HTML, of de fix zit in het desktop-template terwijl mobiel een ander template gebruikt. Stuur me je URL en het probleem, dan stuur ik je een paar momenten. Ik bekijk eerst je field data, daarna besteden we een uur aan je site, en binnen een dag heb je mijn notities op schrift. €350 excl. btw.

Stuur me je URL

Geen developer om de fix te bouwen? Ik doe het werk zelf, op een kopie van je site.

Arjen KarelCore Web Vitals nog steeds rood op mobiel?Stuur me je URL