skill

performance-profiling · davila7 — Claude Code skill: profile, then optimize

Q: How do I install performance-profiling in Claude Code?

Use the templates CLI: `npx claude-code-templates@latest --skill development/performance-profiling`. Alternatively run `npx skills add davila7/claude-code-templates --skill performance-profiling -a claude-code`.

Q: What is needed to run the audit script?

Python. The script is invoked as `python scripts/lighthouse_audit.py https://example.com`. The skill only reads and measures — its tools are `Read`, `Glob`, `Grep` and `Bash`.

A Claude skill that keeps the agent on a fixed loop: measure, find the bottleneck, change one thing, confirm the result. Useful when a page drags.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --skill development/performance-profiling

Open on GitHub

What performance-profiling does

The skill lays out an order of operations for performance work. Baseline first, then locate the bottleneck, then make a targeted change, then validate it. Skip the baseline and the agent starts guessing, which sends fixes in the wrong direction.

It ships as reference tables. Core Web Vitals targets for LCP, INP and CLS. A tool-selection table: Lighthouse for page load, a bundle analyzer for size, the Performance and Memory tabs in DevTools for runtime and heap. Symptoms map to likely causes — slow first load, heavy event handlers, janky scrolling, memory that keeps climbing. A separate anti-pattern table pushes back on micro-optimizing and on optimizing before you have data.

For an automated pass there is scripts/lighthouse_audit.py, run through Python. The skill's allowed tools are Read, Glob, Grep and Bash, so it inspects and measures rather than editing files — the agent applies the changes.

What it helps with

pin down what actually slows a page down
capture a baseline before touching anything
inspect a bundle and drop duplicate dependencies
tell a memory leak apart from normal heap growth
pick the right tool for a given symptom

Example prompts for the agent

Run a performance audit of https://example.com with scripts/lighthouse_audit.py
Take a baseline for LCP and INP, then tell me what to fix first
Look at the bundle: which dependencies are largest, and what should be split per route

How to install performance-profiling

1claude-code-templates

npx claude-code-templates@latest --skill development/performance-profiling

2Skills CLI (Vercel)

npx skills add davila7/claude-code-templates --skill performance-profiling -a claude-code

3Manually: put the files in place

~/.claude/skills/performance-profiling/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/performance-profiling/

Manually: put the files in place

.agents/skills/performance-profiling/SKILL.md

For all projects use ~/.agents/skills/

Manually: put the files in place

.cursor/skills/performance-profiling/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install davila7/claude-code-templates performance-profiling

2Manually: put the files in place

.github/skills/performance-profiling/SKILL.md

Platform CLI

gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/performance-profiling

Manually: put the files in place

.devin/skills/performance-profiling/SKILL.md

The legacy .windsurf/skills/ path still works

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about performance-profiling

How do I install performance-profiling in Claude Code?

Use the templates CLI: npx claude-code-templates@latest --skill development/performance-profiling. Alternatively run npx skills add davila7/claude-code-templates --skill performance-profiling -a claude-code.

What does performance-profiling do?

It gives the agent a method for performance work: measure, locate the bottleneck, make one targeted fix, verify it. Alongside that come metric targets, tool selection and a list of common causes.

What is needed to run the audit script?

Python. The script is invoked as python scripts/lighthouse_audit.py https://example.com. The skill only reads and measures — its tools are Read, Glob, Grep and Bash.

performance-profiling by other authors comes first.

performance-profiling MengTo Guides performance profiling for Apple apps using Instruments and MetricKit. It directs the AI agent to pinpoint hangs and slow launch times. CX Codex +1 1,400installs performance-profiling HeshamFS Finds bottlenecks in materials simulations: parses timing logs, calculates MPI scaling efficiency, and estimates memory requirements. CX Codex +1 ★ 83repo stars setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set361

The whole set →

svelte-debug Reads a Svelte or SvelteKit error and stack trace, finds whether the cause is compilation, runtime or config, and hands you a fix. 134installs publisher-medium Turns a blog post from markdown, PDF or a URL into HTML you can paste into Medium, with markers showing where images go. 134installs paper-2-web Turns an academic paper in LaTeX or PDF into an interactive homepage, a conference poster and a presentation video. Handy before a talk or when promoting a preprint. 133installs task-from-pr Turns a GitHub pull request into a Linear task, with a size estimate, team assignment and links running both ways. 133installs linear-task-to-issue A slash command that turns a Linear task into a GitHub issue, carrying over fields, links, attachments and comments. Useful when planning lives in Linear and code lives in GitHub. 129installs bulk-import-issues A slash command that migrates GitHub issues into Linear in batches, with filtering by label or milestone and retries when a batch fails. 129installs react-useeffect A skill that walks through React's useEffect rules from the official docs and points out what to use instead when an Effect is unnecessary. 127installs svelte-scaffold Builds out a new SvelteKit project, feature module or component library with a ready folder layout and config files. Handy when you want a starting point without wiring it by hand. 127installs