SkillAgentSearch skills...

high-perf-browser

Optimize web performance through network protocols, resource loading, and browser rendering internals

Install / Use

npx skills add wondelai/skills --skill high-perf-browser

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

84/100

Category

Marketing

Supported Platforms

Universal

Our assessment of high-perf-browser

high-perf-browser scores 84/100 on our quality scale, 476th of 642 Marketing skills we index.

Its SKILL.md is 16 KB long, well organised into 14 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 2,248 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
13/20
Description
12/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so high-perf-browser is actively maintained.
  • Our last check on 2026-11-05 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk β€” read a skill before letting an agent act on it.

high-perf-browser compared with similar skills

All 4 of these similar skills score higher than high-perf-browser; compare them before choosing.

SkillScoreStarsUpdatedFormat
high-perf-browser (this skill)by wondelai842.2k2mo agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install high-perf-browser?
Run npx skills add wondelai/skills --skill high-perf-browser. The install tabs above show the steps for each supported agent.
Which AI agents does high-perf-browser work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is high-perf-browser safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is high-perf-browser still maintained?
The repository was last updated about 2 months ago, so high-perf-browser is actively maintained.

name: high-perf-browser description: 'Optimize web performance through network protocols, resource loading, and browser rendering internals. Use when the user mentions "my site is slow", "Core Web Vitals", "HTTP/2 or HTTP/3", "resource hints", "network latency", "render blocking", "TCP/TLS optimization", "service worker", "Cache-Control or caching strategy", or "critical rendering path". Also trigger when diagnosing slow page loads, optimizing time to first byte, choosing between WebSocket and SSE, or reducing bundle sizes. For UI visual performance, see refactoring-ui. For font loading, see web-typography.' license: MIT metadata: author: wondelai version: "1.4.1"

High Performance Browser Networking Framework

A systematic approach to web performance grounded in how browsers, protocols, and networks actually work. Apply these principles when building frontend applications, setting performance budgets, configuring servers, or diagnosing slow page loads.

Core Principle

Latency, not bandwidth, is the bottleneck. Most web performance problems stem from too many round trips, not too little throughput. A 5x bandwidth increase yields diminishing returns; a 5x latency reduction transforms the user experience.

The foundation: Every request passes through DNS resolution, TCP handshake, TLS negotiation, and HTTP exchange before a single byte of content arrives β€” each step adding round-trip latency. High-performance applications minimize round trips, parallelize requests, and eliminate unnecessary network hops. Understanding the protocol stack is the prerequisite for meaningful optimization.

Scoring

Goal: 10/10. Score by how many of the eight Quick Diagnostic rows pass, weighted toward the field metrics: 9-10 = all eight pass (the four field-metric rows in the green plus content-hashing, HTTP/2+, minimized render-blocking, and compression); 5-6 = the four field-metric rows pass but one or more transport/caching/compression rows fail; <=3 = any field-metric row is in the red. Always report the score, which diagnostic rows failed, and the specific fix for each.

The High Performance Browser Networking Framework

Six domains for building fast, resilient web applications:

1. Network Fundamentals

Core concept: Every HTTP request pays a latency tax β€” DNS lookup, TCP three-way handshake, TLS negotiation β€” before any application data flows. Reducing or eliminating these round trips is the single highest-leverage optimization.

Why it works: Light travels at a finite speed: a New York–London packet takes ~28ms one way regardless of bandwidth. These physics-level constraints cannot be solved with bigger pipes β€” only with fewer trips.

Key insights:

  • TCP three-way handshake adds one full RTT before data transfer begins
  • TCP slow start limits initial throughput to ~14KB (10 segments) in the first round trip β€” keep critical resources under this threshold
  • Upgrade to TLS 1.3: it halves the handshake round trips of TLS 1.2 and enables 0-RTT resumption for returning visitors
  • Head-of-line blocking in TCP means one lost packet stalls all streams on that connection
  • Bandwidth-delay product caps in-flight data; high-latency links underutilize bandwidth

Code applications:

| Context | Pattern | Example | |---------|---------|---------| | Connection warmup | Pre-establish connections to critical origins | <link rel="preconnect" href="https://cdn.example.com"> | | DNS prefetch | Resolve third-party domains early (saves 20-120ms) | <link rel="dns-prefetch" href="https://analytics.example.com"> | | TLS optimization | TLS 1.3 + session resumption | ssl_protocols TLSv1.3; with session tickets | | Connection reuse | Keep-alive avoids repeated handshakes | Connection: keep-alive (default in HTTP/1.1+) |

See references/network-fundamentals.md when tuning servers or diagnosing handshake latency β€” the full TLS 1.2-vs-1.3 RTT derivation, slow-start doubling table, initcwnd/BDP math, OCSP-stapling Nginx config, and the DNS cache hierarchy.

2. HTTP Protocol Evolution

Core concept: HTTP evolved from a simple request-response protocol into a multiplexed, binary system. Choosing the right protocol version and configuring it properly eliminates entire categories of performance problems.

Why it works: HTTP/1.1 forces workarounds (domain sharding, sprites, concatenation) because it cannot multiplex. HTTP/2 multiplexes but inherits TCP head-of-line blocking; HTTP/3 (QUIC over UDP) eliminates it. Each generation removes a bottleneck β€” and makes the previous generation's workarounds counterproductive.

Key insights:

  • HTTP/1.1 allows one outstanding request per TCP connection; browsers open 6 per host as a workaround
  • HTTP/2 multiplexes unlimited streams over one connection β€” domain sharding becomes counterproductive
  • HPACK header compression in HTTP/2 cuts repetitive header overhead by 85-95%
  • HTTP/3 (QUIC) eliminates TCP head-of-line blocking and enables 0-RTT resumption and connection migration
  • Prefer 103 Early Hints over HTTP/2 Server Push (which over-pushes and is widely deprecated)
  • Connection coalescing lets one HTTP/2 connection serve multiple hostnames sharing a certificate

Code applications:

| Context | Pattern | Example | |---------|---------|---------| | HTTP/2 migration | Remove HTTP/1.1 workarounds | Undo domain sharding, sprites, file concatenation | | 103 Early Hints | Send preload hints before the full response | 103 with Link: </style.css>; rel=preload | | QUIC/HTTP/3 | Advertise HTTP/3 on CDN or origin | Alt-Svc: h3=":443" header | | Stream prioritization | Signal resource importance | CSS and fonts highest priority; images lower |

See references/http-protocols.md when picking or migrating a protocol version β€” side-by-side HTTP/1.1-vs-2-vs-3 comparison, the step-by-step de-sharding migration, and why Server Push lost to 103 Early Hints.

3. Resource Loading and Critical Rendering Path

Core concept: The browser must build the DOM, CSSOM, and render tree before painting pixels: HTML β†’ DOM β†’ CSSOM β†’ Render Tree β†’ Layout β†’ Paint β†’ Composite. Any resource that blocks this pipeline delays first paint.

Why it works: CSS is render-blocking (no paint until CSSOM is ready) while JavaScript is parser-blocking (<script> halts DOM construction until it downloads and executes) β€” so each needs a different optimization strategy. Every blocking resource adds latency directly to time-to-first-paint.

Key insights:

  • async downloads in parallel and executes immediately (use for independent scripts); defer downloads in parallel but executes after DOM parsing (use for most scripts)
  • <link rel="preload"> fetches critical resources at high priority now; rel="prefetch" fetches likely next-navigation resources at low priority
  • Inline above-the-fold CSS and async-load the rest to eliminate the render-blocking CSS request
  • Fonts can block text rendering for up to 3s β€” use font-display: swap

Code applications:

| Context | Pattern | Example | |---------|---------|---------| | Critical CSS | Inline above-the-fold styles in <head> | <style>/* critical */</style> + async full CSS | | Script loading | defer by default; async for independents | <script src="app.js" defer></script> | | Resource hints | Preload critical fonts, hero images | <link rel="preload" href="font.woff2" as="font" crossorigin> | | Image optimization | Lazy-load below-fold; modern formats | <img loading="lazy" src="photo.avif" srcset="..."> |

See references/resource-loading.md when shaving first paint β€” the exact async/defer/module execution order, the full resource-hint decision tree, and the image/font (font-display, srcset, AVIF) playbook.

4. Caching Strategies

Core concept: The fastest network request is one that never happens. Layer caches β€” browser memory, disk, service worker, CDN, origin β€” to eliminate round trips for repeat visitors.

Why it works: Cache-Control headers tell the browser and intermediaries exactly how long a response stays valid; content-hashed URLs make aggressive immutable caching safe. Each cache hit eliminates a full network round trip.

Key insights:

  • Cache-Control: no-cache still caches but revalidates every time; no-store never caches β€” don't confuse them
  • ETag / Last-Modified enable conditional requests (304 Not Modified) that skip the body transfer
  • Service workers provide a programmable cache layer that works offline (cache-first shell, network-first dynamic content)
  • Misconfigured Vary headers cause CDN cache pollution β€” serve the wrong encoding or format to the wrong client

Code applications:

| Context | Pattern | Example | |---------|---------|---------| | Static assets | Immutable cache + hash busting | style.a1b2c3.css with Cache-Control: max-age=31536000, immutable | | HTML documents | Revalidate on every request | Cache-Control: no-cache with ETag | | API responses | Short TTL + background refresh | Cache-Control: max-age=60, stale-while-revalidate=3600 | | CDN config | Cache at edge with correct Vary | Vary: Accept-Encoding, Accept |

See references/caching-strategies.md when designing a cache policy β€” the full browser/SW/CDN/origin hierarchy, copy-paste service-worker cache-first vs network-first recipes, and the Vary pitfalls that pollute a CDN.

5. Core Web Vitals Optimization

Core concept: Core Web Vitals β€” LCP, INP, CLS β€” are Google's user-centric metrics covering loading, interactivity, and visual stability. They impact search ranking and reflect real user experience.

Why it works: A fast TTFB means nothing if the hero image still loads late (LCP) or main-thread JavaScript blocks interactions (INP) β€” so server-side timing can look green while users wait. Optimize the perceived milestones, not the byte-delivery clock.

Key insights (numeric pass/fail thresholds live in the Quick Diagnostic):

  • LCP β€” optimize the largest visible element (hero image, heading block, video poster)
  • INP β€” keep the main thread free; break long tasks so every interaction (not only the first) stays responsive
  • CLS β€” reserve space for dynamic content before it loads
  • TTFB and FCP (< 1.8s) are upstream gates: they bound every downstream milestone, so fix them first
  • Measure with Real User Monitoring (RUM) in production β€” lab/synthetic tests miss real-device and network variance

Code applications:

| Context | Pattern | Example | |---------|---------|---------| | LCP | Preload LCP element; raise its priority | <img src="hero.webp" fetchpriority="high"> | | INP | Break long tasks; yield to main thread | scheduler.yield() or setTimeout chunking | | CLS | Reserve space for async content | <img width="800" height="600"> or CSS aspect-ratio | | Performance budget | Fail CI when a vital regresses past its Quick Diagnostic threshold | Lighthouse CI assertions on LCP/INP/CLS |

See references/core-web-vitals.md when a metric is in the red β€” per-metric debugging workflows (what to inspect for a bad LCP/INP/CLS), the lab-vs-RUM tooling map, and per-vital optimization checklists.

6. Real-Time Communication

Core concept: When data must flow continuously, the transport choice β€” WebSocket, SSE, or long polling β€” determines latency, resource usage, and scalability.

Why it works: HTTP's request-response model adds overhead to every real-time update. WebSocket offers full-duplex with ~2-byte framing; SSE offers simpler server-to-client push over plain HTTP. Match the transport to the data flow direction and frequency instead of defaulting to the most powerful option.

Key insights:

  • WebSocket: bidirectional (chat, gaming, c

Truncated for display β€” read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars2.2k
CategoryMarketing
Updated2mo ago
Forks228

Languages

Shell

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

No cautions
high-perf-browser β€” Universal Skill: Install & Safety Check | SkillAgent