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
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/w-perf/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/w-perf/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a codex2Manually: put the files in place
.agents/skills/w-perf/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a cursor2Manually: put the files in place
.cursor/skills/w-perf/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install blockmatic-icebox/basilic-skills skills/workflow/w-perf2Manually: put the files in place
.github/skills/w-perf/SKILL.md1Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a gemini-cli2Platform CLI
gemini skills install https://github.com/blockmatic-icebox/basilic-skills --path skills/workflow/w-perfManually: put the files in place
.devin/skills/w-perf/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add blockmatic-icebox/basilic-skills --skill w-perf -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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