← Improve
Improve · 3 tools · on its own branch

Faster and accessible

Slow pages, poor phone scores, or people who can't use the site with a keyboard or screen reader.

What you get: Measurements before and after, and the fixes in small, separate commits.

Paste this into Claude Code, in your project

Paste into Claude Code
You are helping me improve a project that already exists. Today's goal is to make it faster and usable by everyone. Work through the steps in order and explain each in a sentence of plain English. Apart from installing the tools listed below on a separate branch, never change anything until I have agreed to it.

1. **Understand the project.** Read the code and tell me in two sentences what it is and how it runs. Then ask me, in one message: which pages or parts matter most, who they are for, and the one thing I want those people to do. Wait for my answers.
2. **Work safely.** Check that git has no uncommitted changes (if it does, ask me what to do), and that git has a name and email set (if not, ask me and set them for this project only). Then switch to a branch called `improve/speed`, creating it if it doesn't exist, so everything can be undone.
3. **Install the tools**, for this project only, one line at a time. Skills copied in with git are pinned to the version that was safety-checked. If Claude Code refuses a line or a commit, tell me and show me the exact command so I can run it myself in a terminal, then carry on.
   - `d=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/web-quality-skills.git afa8da942115f2961fdbfa80807ea0b232ff6c00 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/core-web-vitals" .claude/skills/core-web-vitals && rm -rf "$d"`: Finds what makes pages slow to load and jumpy. Some of its links point to sister files that aren't copied in; it works without them.
   - `d=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/web-quality-skills.git afa8da942115f2961fdbfa80807ea0b232ff6c00 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/accessibility" .claude/skills/accessibility && rm -rf "$d"`: Checks the site works for everyone, keyboard and screen reader included.
   - `d=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/agent-skills.git 1401c8b8030e023baeebb31781a6653fe8e93026 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/performance-optimization" .claude/skills/performance-optimization && rm -rf "$d"`: Fixes the slow parts once they are measured. Some of its links point to sister files that aren't copied in; it works without them.
   Commit the installed tools on the branch, so throwing the branch away removes them too.
4. **Look before changing.** Measure how fast and how accessible the main pages are, and rank the problems by impact. Use what the installed tools say about doing this well. First, if you notice anything urgent outside today's goal (lost data, a broken feature, a password or key in the code), list it under "Urgent, outside today's goal"; if a key or password was ever committed, tell me to rotate it, because deleting it does not remove it from git history. Then give me the findings ranked by impact, the biggest first, each in one line with why it matters. Stop and ask which to do.
5. **Change in small batches.** Do only what I picked, a few changes at a time. For each batch, show me every change as before and after, and wait for me to accept or reject each one. Then run the project's check (as `CLAUDE.md` describes it now). If there is none, or something can only be checked by a person (looking at a page, a screenshot you cannot take, a speed test you cannot run), say so, measure what you can from the code, tell me exactly what to look at, and wait for my "looks good". If a fix needs something only I can choose (a service, an account, something that costs money), stop and lay out the options with their trade-offs instead of picking one. Only then commit the batch with a clear message.
6. **Hand over.** What I end up with: Measurements before and after, and the fixes in small, separate commits. Then tell me how to keep the changes (merge the `improve/speed` branch) or throw them away (delete it), with the exact commands.
Prompt tested 5 Oct 2026: passed on run 3
How it was tested

A fresh Claude agent pasted the prompt into an empty or sample project and followed it to the letter, on a computer without Node.js. At phone width the page went from a shrunk 980px layout to 375px, body text contrast from 2.85:1 to 12.6:1, labelled form fields from 0 of 3 to 3 of 3, and buttons to a 44px touch size. A leaked key and lost enquiries were reported first.

What it installs, and why

  1. skill

    core-web-vitals ↗

    Finds what makes pages slow to load and jumpy. Some of its links point to sister files that aren't copied in; it works without them.

    Safety-scanned 5 Oct 2026 at afa8da9 · scan cleanWorks in: Chat · Cowork · Claude Coded=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/web-quality-skills.git afa8da942115f2961fdbfa80807ea0b232ff6c00 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/core-web-vitals" .claude/skills/core-web-vitals && rm -rf "$d"
  2. skill

    accessibility ↗

    Checks the site works for everyone, keyboard and screen reader included.

    59.4k installsSafety-scanned 5 Oct 2026 at afa8da9 · scan cleanWorks in: Chat · Cowork · Claude Coded=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/web-quality-skills.git afa8da942115f2961fdbfa80807ea0b232ff6c00 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/accessibility" .claude/skills/accessibility && rm -rf "$d"
  3. skill

    performance-optimization ↗

    Fixes the slow parts once they are measured. Some of its links point to sister files that aren't copied in; it works without them.

    845 installsSafety-scanned 5 Oct 2026 at 1401c8b · scan cleanWorks in: Chat · Cowork · Claude Coded=$(mktemp -d) && git -C "$d" init -q && git -C "$d" fetch -q --depth 1 https://github.com/addyosmani/agent-skills.git 1401c8b8030e023baeebb31781a6653fe8e93026 && git -C "$d" checkout -q FETCH_HEAD && mkdir -p .claude/skills && cp -R "$d/skills/performance-optimization" .claude/skills/performance-optimization && rm -rf "$d"