Skip to main content
skill CX Codex

w-perf — Claude Code skill for performance checks

The w-perf Claude Code skill measures project performance and locates bottlenecks. It runs on requests to investigate slow code or improve performance.

MIT 647 installs ★ 1 updated 2026-10-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a claude-code
Open on GitHub

What w-perf does

w-perf establishes a measured baseline, then uses the repository's profiler, traces, tests, or gh job timing to locate a hot path. It reads the testing documentation first and checks for existing performance budgets. Estimates do not replace measurements.

The skill proposes the smallest change and measures again after a modification. Its default mode is reporting only; it changes code when the user explicitly asks it to implement a fix. It does not invent SLOs or impact percentages. If a new budget is needed, w-perf records it in the existing testing docs. Changes to behavior or commands trigger a documentation update through /w-docs.

What it helps with

  • locate a slow query, render path, or allocation
  • measure a project's performance baseline
  • choose a small optimization backed by measurements
  • compare performance after a code change

Example prompts for the agent

  • Find the bottleneck in this project and show the measurements.
  • Measure test runtime and suggest the smallest performance fix.
  • Implement a fix for the slow path and measure it again.

How to install w-perf

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a claude-code

2Manually: put the files in place

~/.claude/skills/w-perf/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-perf/

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

Questions about w-perf

How do I install w-perf in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a claude-code. The skill file is at ~/.claude/skills/w-perf/SKILL.md.

What does w-perf do?

It measures performance with repository tools such as a profiler, traces, tests, or gh job timing, then identifies a hot path and suggests a small change. It only implements changes on explicit request.

Does w-perf apply fixes automatically?

No. It reports findings and recommends changes by default. It implements a fix and measures again only when asked.

Source text

SKILL.md · MIT
---
name: w-perf
description: Measure bottlenecks with repository tools, then recommend or apply evidenced optimizations.
disable-model-invocation: true
---

Find performance issues with a measured baseline. Do not invent SLOs or impact percentages. Report-only unless the user asked to implement.

1. Read testing docs for budgets if present. Capture a baseline with the repo profiler, traces, tests, or `gh` job timing — not estimates.
2. Locate the owning hot path (query, render, allocation) with that evidence.
3. Recommend the smallest change. Implement only when authorized. Re-measure after a change.
4. If a new budget is required, document it in existing testing docs instead of inventing an SLO here.
5. Docs: `/w-docs` if behavior or commands changed.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

All skills for Testing and QA →

From the same set45

The whole set →
w-review-plan The w-review-plan Claude Code skill checks a plan’s goals, assumptions, tasks, risks, and references. It compares the plan with project code and docs. CX Codex +1 649installs w-errors w-errors — a Claude Code skill that adds error handling in line with a repository’s conventions. Invoke it explicitly while changing code. CX Codex +1 647installs w-refactor The w-refactor Claude Code skill restructures selected code while preserving its behavior. It starts by recording a baseline with tests, type checks, or a manual scenario. CX Codex +1 647installs w-a11y The w-a11y Claude Code skill checks UI accessibility against a repository’s docs and tests. It reports findings by default and changes code only when asked to fix issues. CX Codex +1 647installs w-form The w-form Claude Code skill guides form work in a Next.js app through the mutation path the project already uses. Invoke it to build a form. CX Codex +1 647installs w-v0 The w-v0 Claude Code skill drafts a v0.dev prompt from the current file, selection, and project stack. It opens the generated link only after OPEN. CX Codex +1 647installs w-shadcn The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui. CX Codex +1 647installs w-ui w-ui — a Claude Code skill for building or reshaping user-facing interfaces around a project’s existing tokens and accessible interactions. It checks rendered screens on desktop and mobile. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open