К основному содержанию
скилл CX Codex

perf · pwguler — скилл для Claude Code: что делает и как установить

Скилл perf для Claude Code и Cursor замеряет скорость кода и диагностирует медленные процессы на основе реальных измерений.

MIT 899 установок ★ 10 обновлён 2026-10-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pwguler/skills --skill perf -a claude-code
Открыть на GitHub

Что делает perf

Скилл задаёт строгий регламент оптимизации кода через замеры, фиксацию базовой линии и поиск лимитирующих ресурсов с помощью профилировщиков. Агент пошагово строит повторяемый тест, проверяет результаты и вносит изменения по одному, сверяя их с исходными показателями. Без четкого замера до изменения код править нельзя.

Инструмент подключается, когда пользователь жалуется на медленную работу, высокую задержку или потребление памяти, а также при сравнении двух вариантов реализации. Процесс требует создания списка задач, фиксации целевых показателей и повторного прогона тестов с чередованием версий. Слишком длинные логи отправляются субагенту для экономии контекстного окна.

Правила запрещают исправлять зависания или падения под видом оптимизации, а также тюнить код без данных профилировщика. После трех безуспешных попыток агент останавливает процесс и передаёт решение пользователю. Измерение неудачного замера фиксируется как провал без попыток скрыть результат.

Какие задачи решает

  • измерить производительность функции до и после правки
  • найти узкое место в медленном коде по профилю
  • сравнить скорость двух разных вариантов реализации
  • диагностировать зависший или медленный процесс

Примеры запросов агенту

  • Замерь производительность этой функции
  • Найди причину высокой задержки в модуле обработки
  • Сравни скорость двух подходов к этой задаче

Как установить perf

1Через Skills CLI (Vercel)

npx skills add pwguler/skills --skill perf -a claude-code

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/perf/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о perf

Как установить perf в Claude Code?

Выполните команды npx skills add pwguler/skills --skill perf -a claude-code и обратитесь к файлу ~/.claude/skills/perf/SKILL.md.

Что делает perf?

Скилл организует процесс оптимизации кода на основе измерений, а не догадок, фиксируя базовую линию и проверяя каждый шаг тестами.

Нужны ли внешние программы для работы perf?

Для поиска узких мест требуются стандартные профилировщики, трассировщики или счетчики производительности.

Исходный текст

SKILL.md · MIT
---
name: perf
description: Make code faster or find why it is slow, from measurements and not from guesses. Read this skill before you change code to make it faster or use less memory. Use it when the user reports slow code, high latency, or high memory use. Use it also to check a speed claim, or to compare the speed of two options. Use it to diagnose a slow or stuck process, a profile, or a trace file.
---

Measure before you change code for speed. A claim about speed without a measurement is only a guess. A change that rests on a guess can make the code slower.

Fast path: when the user only asks whether a measured number holds, change no code. Read the `verify` skill, and check the number with [measurement.md](references/measurement.md). When the user asks only why code is slow, or gives a profile or trace file, also change no code. Go to step 4, and report as its reference says.

1. Before you measure anything, create a task list with these steps as its items. If a task list already exists, add the steps to it. When you skip a step, mark it done and add `skip: <reason>` to its text. To go back to an earlier step, add that step and each step after it again as new items.
2. State the target in one sentence: the operation, the input, and the number that counts as success. Take the target from the user or the spec. When nobody gave one, the target is a gain larger than the spread on a realistic input. Say so.
3. Build a measurement that you can run again: a script or a command, and a realistic input. Run each side five times or more. Check the measurement with [measurement.md](references/measurement.md) before you trust it. Step 4 answers its first check. Record the baseline: the number, its unit, the run count, and the spread.
4. Find the limiter, the one resource that stops the number from getting better, by observation. Do not guess it from the source. Use a profiler, a trace, or counters. A profiler slows the work, so never report a number from a profiled run. For a running process, follow [live-process.md](references/live-process.md). For a profile, trace, dump, or log file that already exists, follow [capture-file.md](references/capture-file.md).
5. Change one thing at the limiter, and try the cheapest kind of change first. First remove work whose result nothing uses. Then do the work once, and keep the result. Then do less work. Then do the work later. Then do it at a time when nobody waits. Then run it in parallel. Make the work itself cheaper only as the last option. A change that keeps results, delays work, or runs work in parallel can change behavior. Give it a failing test first, as implement says.
6. Measure again with the same setup, and run the old and new versions in alternating order. Run the tests that exercise the changed path. Keep the change only when they pass and the gain is larger than the spread. Otherwise revert it. When a kept change meets the target, go to step 7. Otherwise go back to step 4.
7. Before you report the gain, read the `verify` skill, and follow it for the tests, the build, and the linter. The measurement script is a demo of the gain, as verify defines a demo. Report the gain as a measured number, not as a verified criterion.
8. Report the result: the number before and after, each with its unit, run count, spread, and limiter. Name the change and the input that you measured.

Rules:

- Change no code for speed before the baseline exists.
- Make one change between two measurements, so that each gain has one cause.
- A request for a diagnosis gets a diagnosis, not a fix. Cite the evidence for each finding.
- A deadlock, a crash, or a wrong result is a defect, not slowness. Its fix goes to `debug`.
- Do not tune code that the measurement does not show as the limiter.
- Stop after three changes in a row that give no gain larger than the spread. Report the measurements and the limiter, and let the user decide.
- When the work continues after the session, keep the measurement script in the diff, as implement's build-the-lever principle says.
- Never invent a number. Report a measurement that failed as failed.
- A raw payload that you must read, and that is longer than about 2,000 lines, goes to a subagent. Keep only the reduced finding in the session, as research's guard-the-context-window principle says.

© pwguler · MIT · pwguler/skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — perf от других авторов.

perf alexj11324 Скилл perf для Claude Code помогает находить и устранять узкие места в сервисах: высокое время ответа, утечки памяти, лишние запросы N+1 и перегрузку процессора. Запускается при профилировании. CX Codex +1 ★ 88звёзд репо w-perf blockmatic-icebox Скилл w-perf для Claude Code измеряет производительность проекта и ищет узкие места. Запускается по запросу на разбор медленного кода или оптимизацию. CX Codex +1 647установок perf-analyzer Community Субагент perf-analyzer для Claude Code собирает выводы профилирования и тестов производительности в структурированные рекомендации с подтверждением фактами из логов или кода. CX Codex ★ 2 003звёзд репо perf-profile Donchitos Скилл perf-profile для Claude Code выявляет узкие места при анализе производительности, сравнивает метрики с бюджетами и ранжирует рекомендации по оптимизации. CX Codex +1 692установок performance-analysis autohandai Скилл performance-analysis инструктирует агента измерять задержки и потребление памяти до правок кода. Помогает найти узкое место с цифрами и проверить результат повторным тестом. CX Codex +1 ★ 219звёзд репо perf-orchestrator Community Субагент perf-orchestrator координирует расследование производительности от базового замера до итогового решения. Следит за последовательными тестами и журналом каждого этапа. CX Codex ★ 2 003звёзд репо performance-benchmarker Michael Galpert Субагент performance-benchmarker для нагрузочного тестирования и профилирования приложения: находит узкие места и предлагает конкретные шаги по оптимизации. ★ 1 013звёзд репо

Из того же набора15

Весь набор →
land Скилл land для Claude Code завершает ветку разработки через слияние, открытие пулл-реквеста, сохранение или удаление. Включается в работу после завершения реализации задачи. CX Codex +1 1 000установок drill Помогает разобрать план или дизайн до согласования решений. Запускается при запросе новой функции, спорном дизайне или просьбе «drill this». CX Codex +1 1 000установок implement Реализует готовый план небольшими срезами через TDD. Включается по запросу написать код по спецификации или фразе «implement this». CX Codex +1 1 000установок rubric Скилл rubric для Claude Code ищет дефекты в изменениях и оценивает качество дизайна, интерфейса или текста. Для оценки вкуса он сначала задаёт критерии, затем передаёт работу независимому субагенту. CX Codex +1 980установок prototype Скилл prototype для Claude Code создаёт визуальные прототипы интерфейсов до начала основной разработки. Он включается по просьбе сделать макет или прототип, когда нужно выбрать внешний вид или сценарий. CX Codex +1 978установок tldr Скилл tldr для Claude Code и Codex формирует итоговый отчёт по задаче в виде результата без пересказа вызовов инструментов. Включается после сборок, тестов, релизов или по запросу о статусе. CX Codex +1 977установок recall Скилл recall для Claude Code собирает краткую сводку о ходе недавней работы по сессиям агента и истории проекта. Запускается перед началом или продолжением задачи, с указанной темой или без неё. CX Codex +1 922установок reflect Скилл reflect собирает уроки из завершённой сессии ИИ-агента и переносит их в проектные файлы, тесты или инструкции для будущих запусков. Запускается в конце сессии, где были ошибки, исправления или неожиданное поведение. CX Codex +1 904установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой