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

llvm-passes — скилл для Claude Code: что делает и как установить

Скилл llvm-passes учит агента писать, собирать и тестировать проходы оптимизации LLVM через New Pass Manager.

MIT 373 установок ★ 298 обновлён 2026-06-27

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

Что делает llvm-passes

Скилл даёт готовые структуры для FunctionPass и ModulePass на C++, регистрацию плагинов через PassPluginLibraryInfo и шаблоны CMakeLists.txt для сборки общих библиотек. Он показывает, как запускать проходы через opt -load-pass-plugin, передавать пайплайны и отслеживать промежуточный IR с флагом -print-after-all.

Внутри есть типовые приёмы работы с анализами (DominatorTree, LoopInfo, AliasAnalysis) и мутации инструкций через IRBuilder. Также включены инструкции по регрессионному тестированию с llvm-lit и FileCheck.

Плагин нужно собирать ровно с той версией LLVM, которую использует бинарник opt, иначе загрузка упадёт с ошибкой несовместимости ABI.

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

  • написать кастомный FunctionPass или ModulePass для New Pass Manager
  • зарегистрировать PassPlugin для загрузки через опцию opt -load-pass-plugin
  • проанализировать граф потока управления через DominatorTree или LoopInfo
  • настроить тесты для трансформаций IR с помощью llvm-lit и FileCheck
  • найти повреждения SSA-формы при отладке флагами verify-each и print-after-all

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

  • Напиши FunctionPass для удаления мёртвых вызовов функций и покажи CMakeLists для сборки плагина
  • Как получить DominatorTree внутри New Pass Manager и безопасно обновить инструкции?
  • Составь тест llvm-lit с проверками FileCheck для моего прохода оптимизации

Как установить llvm-passes

1Через Skills CLI (Vercel)

npx skills add mohitmishra786/low-level-dev-skills --skill llvm-passes -a claude-code

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

~/.claude/skills/llvm-passes/SKILL.md

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

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

Вопросы о llvm-passes

Как установить llvm-passes в Claude Code?

Выполните команду npx skills add mohitmishra786/low-level-dev-skills --skill llvm-passes -a claude-code в терминале.

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

Он предоставляет модели правила и шаблоны кода для разработки компиляторных оптимизаций под LLVM New Pass Manager, включая анализ IR, сборку плагинов и тесты через llvm-lit.

Почему opt выдаёт ошибку при загрузке скомпилированного плагина?

Чаще всего плагин собран с заголовочными файлами одной версии LLVM, а запускается через утилиту opt другой версии: сборку нужно привязывать к llvm-config --cmakedir целевого тулчейна.

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

SKILL.md · MIT
---
name: llvm-passes
description: LLVM passes skill for writing compiler optimizations. Use when writing FunctionPass or ModulePass, registering PassPlugins, running with opt, using analysis utilities, or testing with llvm-lit. Activates on queries about LLVM pass, PassPlugin, opt -passes, DominatorTree, llvm-lit, or New Pass Manager.
---

# LLVM Passes

## Purpose

Guide agents through writing LLVM optimization passes with the New Pass Manager: `FunctionPass` and `ModulePass` structure, `PassPluginLibraryInfo` registration, running via `opt -load-pass-plugin`, common analysis utilities (`DominatorTree`, `LoopInfo`, `AliasAnalysis`), IR modification patterns, `llvm-lit` testing, and debugging with `opt -print-after-all`.

## When to Use

- Adding a custom optimization to an LLVM-based compiler
- Writing an IR transformation pass (inlining, DCE, custom lowering)
- Analyzing control flow with dominator trees or loop info
- Testing passes with FileCheck and llvm-lit
- Debugging pass ordering and IR corruption
- Integrating passes into Clang via plugin

## Workflow

### 1. New Pass Manager architecture

```
opt / clang
├── ModulePassManager
│   └── FunctionPassManager (per function)
│       └── FunctionPass instances
└── AnalysisManager (cached analyses)
```

Passes declare analysis usage; analyses are invalidated on IR mutation.

### 2. Minimal FunctionPass (C++ plugin)

```cpp
// MyPass.cpp
#include "llvm/IR/PassManager.h"
#include "llvm/Passes/PassBuilder.h"
#include "llvm/Passes/PassPlugin.h"
#include "llvm/Support/raw_ostream.h"

using namespace llvm;

namespace {

struct MyPass : PassInfoMixin<MyPass> {
    PreservedAnalyses run(Function &F, FunctionAnalysisManager &AM) {
        bool changed = false;
        for (BasicBlock &BB : F) {
            for (Instruction &I : BB) {
                if (auto *Call = dyn_cast<CallInst>(&I)) {
                    if (Call->getCalledFunction() &&
                        Call->getCalledFunction()->getName() == "dead_func") {
                        Call->eraseFromParent();
                        changed = true;
                    }
                }
            }
        }
        return changed ? PreservedAnalyses::none() : PreservedAnalyses::all();
    }
};

} // namespace

extern "C" LLVM_ATTRIBUTE_WEAK PassPluginLibraryInfo llvmGetPassPluginInfo() {
    return {
        LLVM_PLUGIN_API_VERSION, "MyPass", "v0.1",
        [](PassBuilder &PB) {
            PB.registerPipelineParsingCallback(
                [](StringRef Name, FunctionPassManager &FPM,
                   ArrayRef<PassBuilder::PipelineElement>) {
                    if (Name == "my-pass") {
                        FPM.addPass(MyPass());
                        return true;
                    }
                    return false;
                });
        }
    };
}
```

```cmake
# CMakeLists.txt
find_package(LLVM REQUIRED CONFIG)
add_library(MyPass MODULE MyPass.cpp)
target_include_directories(MyPass SYSTEM PRIVATE ${LLVM_INCLUDE_DIRS})
target_compile_definitions(MyPass PRIVATE ${LLVM_DEFINITIONS})
llvm_map_components_to_libnames(llvm_libs core passes support)
target_link_libraries(MyPass PRIVATE ${llvm_libs})
```

```bash
cmake -B build -DLLVM_DIR=$(llvm-config --cmakedir)
cmake --build build
```

### 3. Running with opt

```bash
# Run pass on IR file
opt -load-pass-plugin ./build/MyPass.so -passes=my-pass -S input.ll -o output.ll

# Print IR after each pass
opt -load-pass-plugin ./build/MyPass.so -passes=my-pass -print-after-all input.ll -o /dev/null

# Pass pipeline string
opt -passes="function(instcombine),my-pass,function(dce)" input.ll -S -o out.ll
```

### 4. ModulePass example

```cpp
struct MyModulePass : PassInfoMixin<MyModulePass> {
    PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM) {
        for (Function &F : M) {
            if (F.isDeclaration()) continue;
            // module-level transformation
        }
        return PreservedAnalyses::none();
    }
};
```

Register on `ModulePassManager` in plugin callback.

### 5. Analysis utilities

```cpp
#include "llvm/Analysis/DominatorTree.h"
#include "llvm/Analysis/LoopInfo.h"
#include "llvm/Analysis/AliasAnalysis.h"

PreservedAnalyses run(Function &F, FunctionAnalysisManager &AM) {
    auto &DT = AM.getResult<DominatorTreeAnalysis>(F);
    auto &LI = AM.getResult<LoopAnalysis>(F);
    auto &AA = AM.getResult<AAManager>(F);

    for (Loop *L : LI) {
        BasicBlock *Header = L->getHeader();
        // Loop invariant code motion, etc.
    }

    DominatorTreeNode *IDom = DT.getNode(&F.getEntryBlock());
    (void)IDom;
    return PreservedAnalyses::all();
}
```

Declare analyses used:

```cpp
AnalysisUsage MyLegacyPass::getAnalysisUsage(AnalysisUsage &AU) const {
    AU.addRequired<DominatorTreeWrapperPass>();
    AU.addRequired<LoopInfoWrapperPass>();
    return AU;
}
```

(New PM: analyses requested via `AM.getResult<>` — dependency auto-tracked.)

### 6. IR modification patterns

```cpp
// Insert instruction before iterator
IRBuilder<> Builder(&*I.getIterator());
Value *NewVal = Builder.CreateAdd(I.getOperand(0), ConstantInt::get(I.getType(), 1));
I.replaceAllUsesWith(NewVal);
I.eraseFromParent();

// Clone basic block
BasicBlock *Clone = CloneBasicBlock(OrigBB, VMap, ".clone", &F);

// Create function
FunctionCallee Fn = M.getOrInsertFunction("my_fn",
    FunctionType::get(Builder.getVoidTy(), false));
```

Always update SSA and invalidate analyses after structural changes.

### 7. llvm-lit testing

```
test/
├── lit.cfg.py
└── my-pass.test
```

```
# my-pass.test
# RUN: opt -load-pass-plugin %shlibdir/MyPass.so -passes=my-pass -S %s | FileCheck %s

define void @test() {
  call void @dead_func()
  ret void
}

; CHECK-NOT: dead_func
```

```bash
llvm-lit test/my-pass.test -v
```

### 8. Debugging passes

```bash
# Verify IR after pass
opt -load-pass-plugin ./MyPass.so -passes=my-pass input.ll -o out.ll
opt -verify-each out.ll

# Time passes
opt -passes=my-pass -time-passes input.ll -o /dev/null

# Debug pass manager
OPT_DEBUG=1 opt -passes=my-pass input.ll -o /dev/null
```

## Common Problems

| Symptom | Cause | Fix |
|---------|-------|-----|
| `Pass not found: my-pass` | Plugin not loaded or name mismatch | Check `registerPipelineParsingCallback` name |
| Verify module failed | Broken SSA after transform | Run `-verify-each`; check use-def chains |
| Analysis stale | Modified IR without invalidation | Return `PreservedAnalyses::none()` |
| Plugin load error | LLVM version mismatch | Build against same LLVM as opt |
| Empty opt output | Forgot `-S` | Add `-S` for textual IR |
| lit test FAIL | CHECK line mismatch | `opt -S` and compare manually |

## Related Skills

- `skills/compilers/llvm` — LLVM IR inspection and opt pipeline as user
- `skills/compiler-internals/compiler-frontend` — IR generation feeding passes
- `skills/compiler-internals/jit-compilation` — ORC JIT running optimized IR
- `skills/compiler-internals/mlir` — MLIR passes (similar concepts)
- `skills/compilers/clang` — Clang optimization flags
- `skills/build-systems/cmake` — building pass plugins

© mohitmishra786 · MIT · mohitmishra786/low-level-dev-skills

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

Все скиллы по теме «Языки программирования» →
llvm sanjeed5 Настраивает Cursor на стандарты кодовой базы LLVM. Заставляет агента использовать структуры ADT, макросы LLVM_DEBUG и тесты LIT. CX Codex +1 ★ 3 589звёзд репо modern-cpp trailofbits Скилл modern-cpp направляет код на C++ к стандарту C++20/23/26, убирая уязвимости памяти и устаревшие конструкции вроде сырых указателей и макросов. CX Codex +1 1 800установок Compiler Explorer compiler-explorer MCP-сервер Compiler Explorer для Claude Code и других AI-агентов. Компилирует код через godbolt.org, показывает ассемблер и создаёт ссылки для обмена результатами. CX Codex +1 ★ 19 201звёзд репо static-analysis gmh5225 Скилл static-analysis передаёт агенту паттерны статического анализа на базе LLVM. Пригодится при написании плагинов компилятора, сканеров уязвимостей и трекинга taint-потоков. CX Codex +1 1установок libfuzzer trailofbits Помогает настраивать и запускать libFuzzer на C/C++ коде под Clang. CX Codex +1 5 800установок build-fix codewithmukesh Скилл build-fix запускает автономный цикл починки сборки и тестов в проектах на .NET. Скилл разбирает ошибки компилятора, исправляет код и останавливается при регрессиях. CX Codex +1 4 000установок

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

Весь набор →
platform-device-model Скилл platform-device-model для Claude Code объясняет привязку Linux-драйверов к platform bus, работу probe и remove, sysfs и deferred probe. Описывает задачи разработки драйверов устройств и работы с Device Tree. CX Codex +1 378установок writing-char-drivers Скилл writing-char-drivers для написания символьных драйверов Linux: регистрация cdev, реализация file_operations, безопасные копии в userspace, ioctl и mmap. CX Codex +1 378установок adc-dac-baremetal Скилл adc-dac-baremetal для настройки АЦП и ЦАП на микроконтроллерах: выбор каналов, время выборки, калибровка, DMA-буферы и выходное напряжение. Пригодится при работе с аналоговыми датчиками, аудио или управляющими сигналами. CX Codex +1 378установок resource-optimization-lowend Скилл resource-optimization-lowend помогает уменьшать расход flash и RAM в прошивках для MCU, разбирать linker map и оценивать глубину стека. CX Codex +1 376установок openmp Скилл учит агента писать и чинить код с OpenMP: параллельные циклы, редукции, задачи, SIMD и выгрузка на GPU. CX Codex +1 371установок numa-programming Скилл numa-programming учит агента работать с NUMA-топологией: определять узлы через numactl и lstopo, привязывать процессы к локальной памяти, использовать libnuma API и строить структуры данных с учётом сокетов. CX Codex +1 369установок dpdk Скилл для работы с DPDK — инициализация EAL, настройка poll-mode драйверов, mbuf-пулы, rte_ring, huge pages, RSS и проверка через testpmd. CX Codex +1 369установок timers-pwm-baremetal Скилл timers-pwm-baremetal для настройки таймеров микроконтроллера без ОС: ШИМ для управления яркостью и скоростью, захват входных импульсов, периодические прерывания через SysTick. Работает на STM32 и других платформах с голым железом. CX Codex +1 367установок

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

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