本文へ移動
cccskills
無料GitHub で公開

webperf-media

Intelligent media optimization with automated workflows for images, videos, and SVGs. Includes decision trees that detect LCP images (triggers format/lazy-loading/priority analysis), identify layout shift risks (missing dimensions), and flag lazy loading issues (above-fold lazy or below-fold eager). Features workflows for complete media audit, LCP image investigation, video performance (poster optimization), and SVG embedded bitmap detection. Cross-skill integration with Core Web Vitals (LCP/CLS impact) and Loading (priority hints, resource preloading). Provides performance budgets and format recommendations based on content type. Use when the user asks about image optimization, LCP is an image/video, layout shifts from media, or media loading strategy. Compatible with Chrome DevTools MCP.

インストール方法を見る

含まれるファイル(7)

  • SKILL.md11.5 KB
  • references/schema.md48.0 KB
  • references/snippets.md1.1 KB
  • scripts/Image-Element-Audit.js6.1 KB
  • scripts/Oversized-Images.js3.7 KB
  • scripts/SVG-Embedded-Bitmap-Analysis.js2.8 KB
  • scripts/Video-Element-Audit.js3.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

WebPerf: Media Performance

JavaScript snippets for measuring web performance in Chrome DevTools.

Running a script

  1. Run the script with mcp__chrome-devtools__evaluate_script and read the object it returns. The scripts have no console output, so the returned object is the result: script, status and the metric data (value, rating, details, items, issues), as described in references/schema.md.
  2. When status is "tracking", the script keeps observing the page. After the interactions, call the function named in getDataFn with another mcp__chrome-devtools__evaluate_script call, for example getINP(), and read the object it returns.
  3. When status is "error" or "unsupported", read error: the page may not have loaded yet, or the browser lacks the API.

Without Chrome DevTools MCP, run the same snippet with the webperf-snippets CLI, which loads the page in headless Chromium and prints the same result objects: npx webperf-snippets <url> --snippet <Name> --json, where <Name> is the script name without .js. It needs Playwright and Chromium (npm install --save-dev webperf-snippets playwright, then npx playwright install chromium), and tracking snippets take --interact-script <file> to drive the interactions.

Scripts

  • scripts/Image-Element-Audit.js — Image element audit
  • scripts/Oversized-Images.js — Oversized images
  • scripts/SVG-Embedded-Bitmap-Analysis.js — SVG embedded bitmap analysis
  • scripts/Video-Element-Audit.js — Video element audit

Common Workflows

Complete Media Audit

When the user asks for media optimization or "audit images and videos":

  1. Image-Element-Audit.js - Analyze all images (format, lazy loading, sizing, fetchpriority)
  2. Video-Element-Audit.js - Analyze all videos (poster, preload, formats, autoplay)
  3. SVG-Embedded-Bitmap-Analysis.js - Detect inefficient bitmap images embedded in SVGs

Image Optimization Workflow

When the user asks "optimize images" or "check image performance":

  1. Image-Element-Audit.js - Full image audit
  2. Cross-reference with webperf-loading skill:
    • Find-Above-The-Fold-Lazy-Loaded-Images.js (incorrectly lazy-loaded images)
    • Find-non-Lazy-Loaded-Images-outside-of-the-viewport.js (missing lazy loading)
    • Find-Images-With-Lazy-and-Fetchpriority.js (contradictory attributes)
    • Priority-Hints-Audit.js (LCP image should have fetchpriority="high")

Oversized Images Audit

When the user asks about images larger than needed, wasted bytes, blurry images, or srcset/sizes problems:

  1. Oversized-Images.js - Compare each image file with the pixels drawn (oversized and undersized)
  2. Image-Element-Audit.js - Check format, lazy loading and srcset usage of the flagged images
  3. Cross-reference with webperf-core-web-vitals skill:
    • LCP.js (check whether an oversized image is the LCP element)

Video Performance Audit

When the user asks "optimize videos" or "check video performance":

  1. Video-Element-Audit.js - Full video audit
  2. Cross-reference with webperf-core-web-vitals skill:
    • LCP-Video-Candidate.js (check if video/poster is LCP)
  3. Cross-reference with webperf-loading skill:
    • Priority-Hints-Audit.js (video poster priority)
    • Resource-Hints-Validation.js (video preload)

LCP Image Investigation

When LCP is an image and needs optimization:

  1. Cross-reference with webperf-core-web-vitals skill:
    • LCP.js (measure LCP)
    • LCP-Image-Entropy.js (analyze image complexity)
  2. Image-Element-Audit.js - Check format, dimensions, lazy loading
  3. Cross-reference with webperf-loading skill:
    • Find-Above-The-Fold-Lazy-Loaded-Images.js (should NOT be lazy)
    • Priority-Hints-Audit.js (should have fetchpriority="high")
    • Resource-Hints-Validation.js (consider preload)

Layout Shift from Images

When CLS is caused by images without dimensions:

  1. Image-Element-Audit.js - Check for missing width/height attributes
  2. Cross-reference with webperf-core-web-vitals skill:
    • CLS.js (measure total CLS)
  3. Cross-reference with webperf-interaction skill:
    • Layout-Shift-Loading-and-Interaction.js (when shifts occur)

SVG Optimization Audit

When the user asks about SVG performance or file sizes are large:

  1. SVG-Embedded-Bitmap-Analysis.js - Detect raster images embedded in vector SVGs
  2. Recommend SVGO optimization for SVGs without embedded bitmaps
  3. Recommend extracting bitmaps to separate image files with proper formats

Decision Tree

Use this decision tree to automatically run follow-up snippets based on results:

After Image-Element-Audit.js

  • If images missing width/height attributes → Layout shift risk, run:

    1. webperf-core-web-vitals:CLS.js (measure CLS impact)
    2. webperf-interaction:Layout-Shift-Loading-and-Interaction.js (timing of shifts)
    3. Recommend adding explicit dimensions to all images
  • If images using wrong format (JPEG for graphics, PNG for photos) → Recommend:

    • Modern formats: WebP, AVIF
    • Appropriate format for content type
    • Format-specific compression settings
  • If images much larger than display size → Recommend:

    • Responsive images with srcset
    • Appropriate image CDN sizing
    • srcset with multiple sizes for different viewports
  • If above-the-fold images are lazy-loaded → Run:

    1. webperf-loading:Find-Above-The-Fold-Lazy-Loaded-Images.js (confirm)
    2. webperf-core-web-vitals:LCP.js (measure LCP impact)
    3. Recommend removing loading="lazy" from above-fold images
  • If LCP image lacks fetchpriority="high" → Run:

    1. webperf-core-web-vitals:LCP.js (measure current LCP)
    2. webperf-loading:Priority-Hints-Audit.js (full priority audit)
    3. Recommend adding fetchpriority="high" to LCP image
  • If below-the-fold images are NOT lazy-loaded → Run:

    1. webperf-loading:Find-non-Lazy-Loaded-Images-outside-of-the-viewport.js (confirm)
    2. Recommend adding loading="lazy" to offscreen images
  • If images have both loading="lazy" AND fetchpriority="high" → Run:

    1. webperf-loading:Find-Images-With-Lazy-and-Fetchpriority.js (confirm contradiction)
    2. Recommend removing one of the conflicting attributes
  • If images competing with critical resources → Run:

    1. webperf-loading:Find-render-blocking-resources.js (resource priority conflicts)
    2. webperf-loading:TTFB-Resources.js (identify slow image CDN)
  • If images missing alt text → Accessibility issue, recommend adding descriptive alt text

After Oversized-Images.js

  • If oversized images found → Recommend:

    • srcset with several widths and an accurate sizes attribute
    • Resizing at build time or with an image CDN
    • Run Image-Element-Audit.js to check format and lazy loading of the same images
  • If an oversized image is the LCP element → Run webperf-core-web-vitals:LCP.js and LCP-Subparts.js (large files inflate resource load duration)

  • If undersized (blurry) images found → Recommend a source with at least the needed pixels and a 2x candidate for high-density screens

  • If skipped images are lazy-loaded → Scroll to the end of the page and run the snippet again

After Video-Element-Audit.js

  • If video is LCP candidate → Run:

    1. webperf-core-web-vitals:LCP-Video-Candidate.js (confirm)
    2. webperf-core-web-vitals:LCP.js (measure LCP)
    3. webperf-core-web-vitals:LCP-Subparts.js (break down timing)
    4. Optimize video poster image or consider image alternative
  • If video missing poster → Recommend:

    • Adding poster image for better perceived performance
    • Using first frame or custom thumbnail
    • Optimizing poster as you would an image
  • If video uses preload="auto" → Bandwidth concern, evaluate:

    • Is video above-the-fold? Keep preload="auto"
    • Is video below-the-fold? Change to preload="metadata" or "none"
    • Is autoplay intended? Verify preload matches intent
  • If autoplay video without muted → Browser will block, recommend:

    • Adding muted attribute
    • Or removing autoplay
  • If video missing multiple formats → Recommend:

    • WebM for Chrome/Firefox
    • MP4 as fallback for Safari
    • Order sources by efficiency (WebM first)
  • If large video files (>5MB) → Recommend:

    • Compression/transcoding
    • Adaptive bitrate streaming (HLS, DASH)
    • Loading strategy optimization

After SVG-Embedded-Bitmap-Analysis.js

  • If bitmap images found in SVGs → Recommend:

    1. Extract bitmaps to separate files
    2. Use WebP/AVIF format for extracted images
    3. Reference images from SVG with <image> element
    4. Or convert to pure vector if possible
  • If large embedded bitmaps (>100KB) → Critical inefficiency:

    • SVG parsing overhead + large bitmap = worst of both worlds
    • Urgently recommend extraction
  • If multiple small bitmaps in SVG → Consider:

    • CSS sprites for small icons
    • SVG symbols for reusable graphics
    • Extracting to individual optimized images

Performance Budget Thresholds

Use these thresholds to trigger recommendations:

Image File Sizes:

  • Warning: Individual image > 500KB → Check format and compression
  • Critical: Individual image > 1MB → Urgent optimization needed
  • Total images: > 5MB on initial load → Implement lazy loading

Image Formats:

  • JPEG for graphics/icons → Recommend PNG or SVG
  • PNG for photos → Recommend JPEG, WebP, or AVIF
  • GIF for animations → Recommend video (MP4/WebM) or animated WebP
  • No modern formats (WebP/AVIF) → Recommend upgrading

Image Dimensions:

  • Intrinsic size > 2x display size → Recommend responsive images
  • Intrinsic size < display size → Upscaling = blurry, provide larger source

Video File Sizes:

  • Warning: Video > 10MB → Consider compression or streaming
  • Critical: Video > 50MB → Urgent optimization or streaming needed

Lazy Loading:

  • Above-fold images lazy-loaded → Critical LCP impact, fix immediately
  • Below-fold images NOT lazy-loaded → Wasted bandwidth, implement lazy loading
  • >10 images eager-loaded → Excessive, implement lazy loading

Priority Hints:

  • LCP image without fetchpriority="high" → Add for 10-30% LCP improvement
  • Non-LCP images with fetchpriority="high" → Remove, wasting browser hints
  • Lazy + fetchpriority="high" conflict → Fix contradiction

References

  • references/snippets.md — Descriptions and thresholds for each script
  • references/schema.md — Return value schema for interpreting script output

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

webperf

無料

Web performance measurement and debugging toolkit. Use when the user asks about web performance, wants to audit a page, or says "analyze performance", "debug lcp", "check ttfb", "measure core web vitals", "audit images", or similar.

日本語の概要は準備中です。原文の説明を表示しています。

nucliweb/webperf-snippets1,4532026年10月18日 更新

Intelligent Core Web Vitals analysis with automated workflows and decision trees. Measures LCP, CLS, INP with guided debugging that automatically determines follow-up analysis based on results. Includes workflows for LCP deep dive (5 phases), CLS investigation (loading vs interaction), INP debugging (latency breakdown + attribution), and cross-skill integration with loading, interaction, and media skills. Use when the user asks about Core Web Vitals, LCP optimization, layout shifts, or interaction responsiveness. Compatible with Chrome DevTools MCP.

日本語の概要は準備中です。原文の説明を表示しています。

nucliweb/webperf-snippets1,4532026年10月18日 更新

Intelligent interaction performance analysis with automated workflows for INP debugging, scroll jank investigation, and main thread blocking. Includes decision trees that automatically run script attribution when long frames detected, break down input latency phases, and correlate layout shifts with interactions. Features workflows for complete interaction audit, third-party script impact analysis, and animation performance debugging. Cross-skill integration with Core Web Vitals (INP/CLS correlation) and Loading (script execution analysis). Use when the user asks about slow interactions, janky scrolling, unresponsive pages, or INP optimization. Compatible with Chrome DevTools MCP.

日本語の概要は準備中です。原文の説明を表示しています。

nucliweb/webperf-snippets1,4532026年10月18日 更新

Intelligent loading performance analysis with automated workflows for TTFB investigation (DNS/connection/server breakdown), render-blocking detection, script performance deep dive (first vs third-party attribution), font optimization, and resource hints validation. Includes decision trees that automatically analyze TTFB sub-parts when slow, detect script loading anti-patterns (async/defer/preload conflicts), identify render-blocking resources, and validate resource hints usage. Features workflows for complete loading audit (6 phases), backend performance investigation, and priority optimization. Cross-skill integration with Core Web Vitals (LCP resource loading), Interaction (script execution blocking), and Media (lazy loading strategy). Use when the user asks about TTFB, FCP, render-blocking, slow loading, font performance, script optimization, or resource hints. Compatible with Chrome DevTools MCP.

日本語の概要は準備中です。原文の説明を表示しています。

nucliweb/webperf-snippets1,4532026年10月18日 更新

Intelligent network quality analysis with adaptive loading strategies. Detects connection type (2g/3g/4g), bandwidth, RTT, and save-data mode, then automatically triggers appropriate optimization workflows. Includes decision trees that recommend image compression for slow connections, critical CSS inlining for high RTT, and save-data optimizations (disable autoplay, reduce quality). Features connection-aware performance budgets (500KB for 2g, 1.5MB for 3g, 3MB for 4g+) and adaptive loading implementation guides. Cross-skill integration with Loading (TTFB impact), Media (responsive images), and Core Web Vitals (connection impact on LCP/INP). Use when the user asks about slow connections, mobile optimization, save-data support, or adaptive loading strategies. Compatible with Chrome DevTools MCP.

日本語の概要は準備中です。原文の説明を表示しています。

nucliweb/webperf-snippets1,4532026年10月18日 更新

nucliweb のスキルをすべて見る

このスキルの問題を報告する