Skip to content

docs: add skill and mcp for chrome-devtools - #8788

Merged
joshblack merged 2 commits into
mainfrom
push-qzknxpllpllq
Nov 17, 2026
Merged

joshblack merged 2 commits into
mainfrom
push-qzknxpllpllq

Conversation

@joshblack

Copy link
Copy Markdown
Member

Add the MCP config and skills for chrome-devtools to help with profiling 👀

Changelog

New

  • Add new skills for chrome-devtools

Changed

  • Update our write-skill skill to just skill
  • Update our mcp config to include the MCP server for chrome devtools

Removed

Rollout strategy

  • None

This is a change to skills only

@joshblack
joshblack requested a review from a team as a code owner November 17, 2026 19:51
@joshblack
joshblack requested review from tay1orjones and a balanced review from Copilot November 17, 2026 19:51
@changeset-bot

changeset-bot Bot commented Nov 17, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 97e4222

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions github-actions Bot added the staff Author is a staff member label Nov 17, 2026
@joshblack
joshblack enabled auto-merge November 17, 2026 19:53
@joshblack joshblack added skip changeset This change does not need a changelog integration-tests: skipped manually Changes in this PR do not require an integration test labels Nov 17, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The viewport checks can misclassify hidden or offscreen images, producing harmful loading recommendations; both checks need nonzero rectangles intersecting the viewport on both axes while preserving the priority check’s size threshold.

1 open issue
What changed in this PR

This PR adds Chrome DevTools tooling and agent guidance for profiling and debugging Primer React, without changing package runtime behavior.

Changes:

  • Configure Chrome DevTools MCP with memory debugging enabled and usage statistics and CrUX lookups disabled.
  • Add browser, performance, memory, accessibility, and LCP investigation skills and references.
  • Rename write-skill to skill and document external skill installation.
File Description
.mcp.json Register the Chrome DevTools MCP server.
.agents/​skills/​skill/​SKILL.md Rename the skill and add installation guidance.
.agents/​skills/​performance/​SKILL.md Define a measurement-driven performance workflow.
.agents/​skills/​performance/​references/​browser.md Document browser profiling and evidence collection.
.agents/​skills/​memory-leak-debugging/​SKILL.md Add heap comparison and retention analysis guidance.
.agents/​skills/​memory-leak-debugging/​references/​common-leaks.md Describe common memory leaks and remedies.
.agents/​skills/​debug-optimize-lcp/​SKILL.md Add an LCP investigation workflow.
.agents/​skills/​debug-optimize-lcp/​references/​optimization-strategies.md Describe optimization options by LCP subpart.
.agents/​skills/​debug-optimize-lcp/​references/​lcp-snippets.md Add LCP identification and image-loading audit snippets.
.agents/​skills/​debug-optimize-lcp/​references/​lcp-breakdown.md Explain LCP timing subparts.
.agents/​skills/​debug-optimize-lcp/​references/​elements-and-size.md Document LCP element eligibility and sizing.
.agents/​skills/​chrome-devtools/​SKILL.md Add MCP inspection and interaction guidance.
.agents/​skills/​chrome-devtools/​LICENSE Include the upstream Apache 2.0 license.
.agents/​skills/​chrome-devtools-cli/​SKILL.md Document CLI commands and browser automation.
.agents/​skills/​chrome-devtools-cli/​references/​installation.md Explain CLI installation and troubleshooting.
.agents/​skills/​a11y-debugging/​SKILL.md Add accessibility auditing workflows.
.agents/​skills/​a11y-debugging/​references/​a11y-snippets.md Provide accessibility inspection snippets.

Review effort: Balanced

Comment on lines +41 to +53
if (rect.top < window.innerHeight) {
issues.push({
issue: 'lazy-loaded image in viewport',
element: img.outerHTML.substring(0, 200),
fix: 'Remove loading="lazy" from this image — it is in the initial viewport and may be the LCP element',
});
}
});

// Check for LCP-candidate images missing fetchpriority
document.querySelectorAll('img:not([fetchpriority])').forEach(img => {
const rect = img.getBoundingClientRect();
if (rect.top < window.innerHeight && rect.width * rect.height > 50000) {
@joshblack
joshblack added this pull request to the merge queue Nov 17, 2026
Merged via the queue into main with commit 5b50bc0 Nov 17, 2026
70 of 71 checks passed
@joshblack
joshblack deleted the push-qzknxpllpllq branch November 17, 2026 20:15

This branch was successfully deployed

1 active and 1 inactive deployments
storybook-preview-8788 — 97e42223 Deployed Nov 17, 2026 by github-actions[bot]
github-pages — 97e42223 Deployed Nov 17, 2026 by joshblack via deploy-preview #34401
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

integration-tests: skipped manually Changes in this PR do not require an integration test skip changeset This change does not need a changelog staff Author is a staff member

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants