ncu-report-skill

Скилл для Claude Code разбирает отчеты Nsight Compute на Blackwell и ведет от замера ядра CUDA к диагнозу и плану оптимизации.

  • 274 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Агент запускает `ncu` и скрипты на вашей машине и читает файлы отчетов.
Все причины и проверки

mit-han-lab/ncu-report-skill

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/ncu-report-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент запускает `ncu` и скрипты на вашей машине и читает файлы отчетов.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

ncu-report-skill проводит агента через профилирование ядра CUDA в Nsight Compute: один замер с набором `--set full`, затем разбор метрик, правил NCU, остановок по строкам кода и временных линий PM-выборки. По найденным признакам агент подбирает причину по плейбуку и пишет отчет с доказательствами. В комплекте шаблон отдельного харнесса на CUDA, загрузчик safetensors, Python-помощники для файлов `.ncu-rep` и справочник по программированию под Blackwell (B200, B300). Скилл рассчитан на Nsight Compute 2026.3.1, для старых версий отчеты тоже читаются.

Для кого. Инженерам, которые оптимизируют ядра CUDA, Triton или CUTLASS на видеокартах NVIDIA и хотят опираться на замеры, а не на догадки.

Подходит, если

  • Ядро работает медленнее бюджета или базовой версии, причина неизвестна.
  • После правки скорость изменилась, а почему, непонятно.
  • На руках файл `.ncu-rep` и нужен план оптимизации с приоритетами.
  • Ядро Triton или CUTLASS остается узким местом, и хочется увидеть остановки по строкам кода.

Не подходит, если

  • Нет видеокарты NVIDIA или установленного `ncu`.
  • Задача про производительность процессора, а не ядер GPU.
  • Нужен готовый патч ядра без этапа измерений.

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

Профилируй ядро `attention_fwd` на B200 для длины последовательности 4096, собери один отчет и назови главное узкое место с планом исправлений.

Ограничения

Скилл написан под Nsight Compute 2026.3 и Blackwell (sm_100, sm_103); флаги, наборы и названия метрик меняются между версиями, поэтому при расхождении сверяйтесь с `ncu --help`. Для замеров нужен доступ к счетчикам GPU, на части систем он требует прав администратора. Для переменных размеров входа агент должен получить реальные формы из вашей нагрузки. Скилл поддерживается как отдельный подмодуль репозитория Kernel Design Agents, обсуждения и ошибки принимают там.

Как отключить. Удалите папку или символическую ссылку `ncu-report-skill` из `~/.claude/skills/` либо из `.claude/skills/` проекта. Каталоги с замерами, созданные агентом, удалите вручную.

Частые вопросы

Как подключить скилл только к одному проекту?

Создайте ссылку в `.claude/skills/ncu-report-skill` внутри репозитория проекта. Для всех проектов сразу ссылку кладут в `~/.claude/skills/`.

Можно ли запустить помощников без Claude?

Да. Скрипты `analyze_reports.py`, `extract_stall_hotspots.py` и `plot_timeline.py` принимают файл `.ncu-rep` и работают самостоятельно, как показано в README.

Что делать, если нет стенда с Blackwell?

Основные советы общие для видеокарт NVIDIA. Заметки по конкретным моделям и версиям в документации помечены отдельно.

Куда писать об ошибках?

В основной репозиторий Kernel Design Agents: этот репозиторий вынесен для удобной установки.

Зачем отдельная папка на каждый запуск?

Так отчеты, харнесс и итоговый `REPORT.md` разных замеров не смешиваются. Правило описано в `reference/00-directory-layout.md`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы
Выбор редакции

Официальный каталог агентских скиллов NVIDIA: работа с CUDA, ускоренными библиотеками, RAG, робототехникой и симуляцией через кодинг-агентов

СкиллРасширенный доступ3,9 тыс.Звезды репозитория

Больше 200 скиллов для разработки на чипах Ascend NPU: диагностика устройств, конвертация моделей, тренировка и Profiling.

СкиллРасширенный доступ182Звезды репозитория

Скилл ускоряет сборку Xcode: замеряет чистые и инкрементальные сборки, находит узкие места и подбирает настройки проекта

СкиллРасширенный доступ1,3 тыс.Звезды репозитория

14 скиллов, которые находят пробелы в задаче до кода: интервью, план, проверка допущений и доказательство исправления бага

СкиллМинимальный доступ363Звезды репозитория

OpenClaw Agent Skills

openclaw-agent-skills

Официальный

Общие скиллы для кодовых агентов, которые работают над проектами OpenClaw: ревью и другие рабочие процессы. Узкая тема для тех, кто пишет код OpenClaw

СкиллРасширенный доступ1,1 тыс.Звезды репозитория

Скилл для ускорения обучения моделей на GPU Moore Threads MUSA: базовый замер, профиль, MFU и проверка численной точности

СкиллРасширенный доступ139Звезды репозитория

Коротко о README

Рабочий порядок: определить цель замера, получить профилируемый код или отдельный харнесс, собрать отчет `--set full`, разобрать шесть измерений анализа и составить отчет с рекомендациями.

Бейдж для README

Сообщить о проблеме

Foxx AIncu-report-skill
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.