web-performance SKILL.md skillB

web-performance from ziniman/ai-instruct is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ziniman/ai-instruct/web-performance@git:20260502.4621eea

Pins git:20260502.4621eea in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
ziniman/ai-instruct
Path
skills/web-performance/SKILL.md
Versions recorded
2
Latest version
git:20260502.4621eea, committed May 2, 2026
First version recorded
Apr 20, 2026
Size
55,395 bytes
Repository stars
29
License
Apache-2.0

Use this skill whenever the user is improving Core Web Vitals or page load performance, or mentions slow pages, PageSpeed Insights / Lighthouse failures, LCP/CLS/INP scores, bundle size, image/font optimization, or third-party script impact. Covers Core Web Vitals, image and font optimization, JavaScript bundle size, CSS build size, CDN caching, third-party JavaScript impact, and measurement tools. Skip for backend latency tuning, database query optimization, or CI build speed.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Web Performance Guide

> Applies to: Any website or web app | Updated: March 2026

A practical reference for measuring and improving web performance - covering Core Web Vitals, image and font optimization, JavaScript bundle size, CSS build size, CDN caching, third-party JavaScript impact, and validation tools.

---

## Section 0: Before You Start

Answer these questions before making any performance changes. Each has a default - use it if the user hasn't said otherwise.

**Q: Which pages are the priority targets?**
(landing page, dashboard, auth-gated app pages, all pages)
Default: public-facing pages first - these are indexed by search engines and directly affect user experience. Auth-gated pages matter less for Core Web Vitals field data because CrUX only collects data from logged-in users on those routes.

**Q: What is the current performance baseline?**
Default: unknown - run PageSpeed Insights on the target URL before making any changes, so you have a before/after comparison. Note the LCP element type (image or text), TTFB, and the specific audits flagged as failing.

**Q: Are you optimizing for lab scores (Lighthouse) or field data (real users)?**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ziniman/ai-instruct/web-performance@sha256:7ab7c83ed441dda1

The line at the top of this page pins the label git:20260502.4621eea, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vmaq6rxzz4vfh5h7.svg)](https://markdownregistry.com/a/art_vmaq6rxzz4vfh5h7)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Apr 20, 2026 and May 2, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
git:20260502.4621eea latest2026-05-02 4621eea 55,395 BB view · diff
git:20260420.0a6f9052026-04-20 0a6f905 43,672 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (55395 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

ziniman/ai-instruct · 29 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vmaq6rxzz4vfh5h7
GET https://markdownregistry.com/api/v1/resolve?ref=ziniman/ai-instruct/web-performance
GET https://markdownregistry.com/api/v1/blob/7ab7c83ed441dda100dde955d13ce52ec1639cf3f5e6e18f08e275d66135dfe8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ziniman/ai-instruct

CLAUDE.md CLAUDE.md file
ziniman/ai-instruct · CLAUDE.md
git:20261020.684a87e · audit A · 29 stars
llms.txt llms.txt file
ziniman/ai-instruct · llms.txt
git:20260311.73a01d3 · audit A · 29 stars
aws-spa-deploy SKILL.md skill
ziniman/ai-instruct · skills/aws-spa-deploy/SKILL.md · Use this skill whenever the user is deploying a React/Vite single-page app to AWS, or mentions Amplify, CDK, or wiring…
git:20260420.0a6f905 · audit A · 29 stars
google-analytics-4 SKILL.md skill
ziniman/ai-instruct · skills/google-analytics-4/SKILL.md · Use this skill whenever the user installs, configures, or debugs Google Analytics 4, or mentions gtag.js, GTM…
git:20260420.0a6f905 · audit F · 29 stars
seo-llmo SKILL.md skill
ziniman/ai-instruct · skills/seo-llmo/SKILL.md · Use this skill whenever the user is building, reviewing, or preparing to launch any public-facing website or web app…
git:20260427.399cd67 · audit B · 29 stars
web-accessibility SKILL.md skill
ziniman/ai-instruct · skills/web-accessibility/SKILL.md · Use this skill whenever the user is building or reviewing any web UI. Accessibility is a baseline requirement, not a…
git:20260420.0a6f905 · audit A · 29 stars

Every file in ziniman/ai-instruct

Other files named web-performance

web-performance SKILL.md skill
yuecao365/offercome · src/lib/mock-interviews/skills/web-performance/SKILL.md · 前端性能深挖:指标与监控、渲染策略、资源加载与缓存、长任务与 INP、视觉稳定、WebView。
git:20260920.a4843f5 · audit A · 24 stars

Browse by kind, by grade B, or by owner.