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

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

Скилл performance для Claude Code, который измеряет нагрузку на CPU, память и энергию в macOS-приложениях. Помогает находить причины зависаний и переносить вычисления с основного потока на GPU.

MIT 1 000 установок ★ 1 933 обновлён 2026-11-05

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

Что делает performance

Скилл автоматизирует профилирование macOS-приложений, чтобы сократить время отклика интерфейса и устранить зависания. Работа строится на цикле: воспроизведение проблемы, замер показателей в релизной сборке, поиск проблемного участка кода и проверка результата после исправлений.

Для работы используются стандартные инструменты sample, xctrace, footprint и leaks. Важно помнить, что Debug Swift работает медленнее, поэтому замеры проводятся только на релизных сборках. Файлы .trace содержат данные окружения, поэтому их нельзя передавать или коммитить в репозиторий.

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

  • найти причину зависания интерфейса
  • снизить нагрузку на CPU и память
  • устранить рывки при анимации
  • проверить энергопотребление приложения

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

  • performance: измерь время отклика при открытии окна
  • performance: проверь почему приложение потребляет много энергии

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

1Через Skills CLI (Vercel)

npx skills add daveebbelaar/bama --skill performance -a claude-code

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

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

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

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

Вопросы о performance

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

Выполните команду npx skills add daveebbelaar/bama --skill performance -a claude-code в терминале.

Что делает скилл performance?

Он измеряет задержки, использование CPU, памяти и энергии, помогая оптимизировать macOS-приложения через перенос задач на GPU.

Что нужно для работы скилла?

Требуется macOS-окружение и установленные инструменты командной строки Apple, такие как xctrace и sample.

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

SKILL.md · MIT
---
name: performance
description: Make a macOS app fast by measuring hangs, stutter, CPU, memory, and energy, then moving work off the main thread and onto the GPU. Use when the app freezes, a shortcut feels slow, dragging stutters, the fan spins, memory grows, or the user asks to optimize or profile.
---

# Performance

Fast means two numbers: the first frame after a key press shows in under
100 ms, and nothing on the main thread blocks for more than 50 ms. Every
change in this skill starts and ends with a **measurement**, so you know it
helped. Symptom-by-symptom fixes are in [recipes.md](recipes.md). For
video, audio, camera, Metal, or large image pipelines, also read
[gpu-media.md](gpu-media.md).

## The loop

```text
reproduce -> measure (release build) -> find the line -> fix -> measure again -> commit with the numbers
```

1. **Reproduce.** Write the exact steps, or add a probe command to the
   debug bridge (`test-mac-app` skill) that runs the slow action and logs
   the time of each step.
2. **Measure the release build.** Debug Swift is 3 to 10 times slower and
   points at the wrong code.
3. **Find the line.** Pick the tool for the symptom:

   | Symptom | Tool |
   | --- | --- |
   | App freezes, spinning pointer | `sample <App> 5`, then read the main thread stack |
   | Slow action | Time Profiler: `xcrun xctrace record --template 'Time Profiler' --attach <App> --time-limit 10s` |
   | Short freezes while typing or dragging | `--template 'Hangs'` |
   | Stutter while moving or animating | `--template 'Animation Hitches'` |
   | Memory grows | `footprint <App>`, `leaks <App>`, `--template 'Allocations'` |
   | Fan, battery | `--template 'Energy Log'`, look for timers and polling |

   Read traces as text, not in the Instruments GUI: see "Measuring" in
   [recipes.md](recipes.md). Delete every `.trace` after reading. A trace
   stores the app's full environment, and an app opened from an agent's
   shell inherits that shell's tokens. Never commit or share one.

4. **Fix** with the matching recipe.
5. **Measure again** with the same steps. Put before and after in the
   commit message: "Picker opens in 40 ms, was 600 ms".

## The rules that fix most problems

- **Main thread does UI only.** File, network, database, image decoding,
  Accessibility calls, and audio go elsewhere. A main-thread call that waits
  on another process (CoreAudio, AX) can freeze the app for minutes.
- **Show first, work after.** Put the window or panel on screen in the same
  frame as the key press, then load. Never make the UI wait for the work.
- **Let the GPU composite.** Large images go in a `CALayer` once. Pointer
  movement changes only small layers. Never redraw a full-screen picture per
  mouse event.
- **Decode at display size.** ImageIO thumbnails, cached in `NSCache`.
- **Do not animate what must be fast.** Search results and switchers
  update in place.
- **No polling without a reason.** Timers get a tolerance and stop when
  nothing on screen needs them.

## Apple silicon notes

- Core Animation, Core Image (one shared `CIContext`), Vision, and
  AVFoundation already run on the GPU or the Neural Engine. Hand them the
  work instead of looping over pixels in Swift.
- Write Metal (`MTKView`, compute shaders) only when a measurement shows
  Core Animation or Core Image is too slow. Most apps never need it.
- Unified memory means a `CGImage` from ScreenCaptureKit passes to a layer
  without a copy. Keep it as a `CGImage` or `IOSurface`. Converting to
  `NSImage` and back costs copies.

Done when the slow action has a measured before and after, the after meets
the two numbers at the top, and the commit message names both.

© daveebbelaar · MIT · daveebbelaar/bama

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

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

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

performance millionco Скилл performance измеряет производительность React во время конкретного взаимодействия и связывает задержки браузера с рендерами компонентов. CX Codex +1 314установок performance plugin87 Скилл performance для Claude Code разбирает скорость интерфейса по метрикам Core Web Vitals. Подключается к задачам по устранению задержек, рывков анимации и скачков макета. CX Codex +1 562установок performance rshankras Скилл performance диагностирует медленные приложения, зависания и утечки памяти через Instruments, а также находит лишние перерисовки и проблемы идентификации представлений в SwiftUI. CX Codex +1 212установок performance OrchestKit Скилл performance помогает находить узкие места во фронтенде, бэкенде и LLM-инференсе: от медленных React-рендеров до задержек API. CX Codex +1 233установок performance cognitedata Скилл performance для Claude Code ищет и исправляет проблемы быстродействия приложения Flows. Он включается при запросах об оптимизации, медленной работе, повторных рендерах и запросах CDF. CX Codex +1 1 900установок native-app-performance steipete Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments. CX Codex +1 251установок swiftui-performance dpearson2699 Скилл swiftui-performance для Claude Code, Cursor, Codex и других агентов, который ведёт от воспроизводимого симптома торможения SwiftUI к измеренному результату. CX Codex +1 5 000установок instruments-profiling steipete Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки. CX Codex +1 242установок agent-performance-engineer Tony363 Скилл agent-performance-engineer для Claude Code помогает находить узкие места и настраивать производительность приложений, баз данных и инфраструктуры. Активируется для задач по профилированию, нагрузочному тестированию и оптимизации. CX Codex +1 556установок performance-profiling MengTo Скилл performance-profiling помогает находить зависания и утечки памяти в приложениях под платформы Apple. Направляет агента по инструментам Instruments и телеметрии MetricKit. CX Codex +1 1 700установок performance-optimization gamedev-skills Скилл performance-optimization для Claude Code находит причины низкой частоты кадров и рывков в Godot, Unity, Unreal и Roblox. Подключается для профилирования игры и выбора самой затратной проблемы. CX Codex +1 14 200установок

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

Весь набор →
research Скилл research для Claude Code собирает онлайн-исследование перед разработкой macOS-приложения. Запускает параллельных субагентов для сравнения приложений, отзывов и возможностей macOS. CX Codex +1 1 000установок improve-loop Скилл improve-loop для Claude Code ведёт разработку macOS-приложения по историям из docs/STORIES.md. Он собирает приложение, сравнивает снимки экранов с образцами и фиксирует готовые истории в Git. CX Codex +1 1 000установок agent-cli Скилл agent-cli для Claude Code, Codex и Cursor добавляет командную строку и MCP-сервер к macOS-приложению, чтобы ИИ управлял им через локальный сокет. CX Codex +1 1 000установок build-and-verify Скилл build-and-verify для Claude Code собирает SwiftUI-приложение для macOS и проверяет снимки страниц в двух темах. Агент запускает его после изменений интерфейса, ошибок сборки или просьбы проверить приложение. CX Codex +1 1 000установок improve-architecture Скилл improve-architecture для Claude Code разбирает архитектуру macOS-приложения на Swift и планирует безопасный рефакторинг. Срабатывает перед крупной функцией, в конце этапа или при повторяющихся проблемах в одной области. CX Codex +1 1 000установок app-brief Скилл app-brief для Claude Code и Cursor создаёт одностраничный файл docs/BRIEF.md для нового приложения под macOS до написания кода. CX Codex +1 1 000установок design-from-app Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок os-integrations Скилл os-integrations для Claude Code помогает выбрать API macOS и нужные разрешения для системных функций приложения. Включается при добавлении глобальных горячих клавиш, захвата экрана или управления окнами других приложений. CX Codex +1 1 000установок

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

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