nemo-relay-migrate-from-flow — скилл для Claude Code
Скилл nemo-relay-migrate-from-flow для механической миграции кода, документации и конфигов с NeMo Flow на NeMo Relay. Работает с Python, Rust, Node.js, Go, C FFI, CLI и параметрами наблюдаемости.
Apache-2.0 171 установок ★ 4 106 обновлён 2026-10-23
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a claude-codeЧто делает nemo-relay-migrate-from-flow
Скилл автоматизирует переименование идентификаторов, путей пакетов и переменных окружения при переходе с NeMo Flow на NeMo Relay. Он обрабатывает все языковые поверхности: переименовывает импорты вида nemo_flow:: на nemo_relay:: в Rust, обновляет package.json и entry points в Node.js, меняет пути в Go модулях, заголовочные файлы и макросы в C FFI, а также конфиги CLI и переменные вроде NEMO_FLOW_*.
Процесс начинается с сухого прогона: скилл запускает встроенный скрипт migrate_from_nemo_flow.py в режиме просмотра, показывает все предлагаемые замены, и только после вашего подтверждения применяет их. Скрипт пропускает lockfiles (их нужно регенерировать инструментами типа Cargo, pip или npm), не трогает локальные конфиги .nemo-flow/config.toml и .nemo-flow/plugins.toml — их вы переместите вручную в поддерживаемый путь.
После миграции скилл помогает проверить результат: ищет оставшиеся ссылки на Flow, запускает тесты для каждого языка и перестраивает документацию, если в неё попали команды установки или ссылки на репозиторий.
Какие задачи решает
- переименовать импорты Python с
nemo_flowнаnemo_relayпо всему коду - обновить пути Rust-пакетов и
use nemo_relay::в крейтах - сменить имена Node.js пакетов и entry points в
package.json - мигрировать Go импорты и структуру каталогов
go/nemo_flow→go/nemo_relay - заменить FFI заголовки, префиксы типов и макросы в C коде
Примеры запросов агенту
- Помоги мне мигрировать проект с NeMo Flow на NeMo Relay, проверь что нужно поменять
- Запусти миграцию для Python и Rust кода в
/path/to/project, покажи все изменения перед применением - Обнови документацию и примеры — замени ссылки на NeMo Flow на NeMo Relay
Как установить nemo-relay-migrate-from-flow
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a claude-code2Вручную: положить файлы
~/.claude/skills/nemo-relay-migrate-from-flow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nemo-relay-migrate-from-flow/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a codex2Вручную: положить файлы
.agents/skills/nemo-relay-migrate-from-flow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a cursor2Вручную: положить файлы
.cursor/skills/nemo-relay-migrate-from-flow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install NVIDIA/skills skills/nemo-relay-migrate-from-flow2Вручную: положить файлы
.github/skills/nemo-relay-migrate-from-flow/SKILL.md1Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a gemini-cli2Командой платформы
gemini skills install https://github.com/NVIDIA/skills --path skills/nemo-relay-migrate-from-flowВручную: положить файлы
.devin/skills/nemo-relay-migrate-from-flow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nemo-relay-migrate-from-flow
Как установить скилл nemo-relay-migrate-from-flow в Claude Code?
Запустите npx skills add NVIDIA/skills --skill nemo-relay-migrate-from-flow -a claude-code, затем обратитесь к файлу ~/.claude/skills/nemo-relay-migrate-from-flow/SKILL.md. Для других платформ используйте соответствующий флаг: -a codex для Codex, -a cursor для Cursor, -a gemini-cli для Gemini CLI.
Что именно делает скилл nemo-relay-migrate-from-flow?
Переименовывает все идентификаторы, пути и переменные с NeMo Flow на NeMo Relay: импорты, имена пакетов, пути каталогов, заголовочные файлы, макросы и переменные окружения. Работает в режиме сухого прогона, чтобы показать изменения перед применением.
Нужно ли вручную обновлять lockfiles и конфиги после миграции?
Да. Lockfiles (Cargo.lock, package-lock.json, go.sum) нужно регенерировать инструментами пакетного менеджера. Файлы .nemo-flow/config.toml и .nemo-flow/plugins.toml скилл не трогает — их нужно переместить вручную в поддерживаемый путь конфигурации.
Исходный текст
SKILL.md · Apache-2.0
--- name: nemo-relay-migrate-from-flow description: Use this skill when migrating applications, examples, integrations, documentation, manifests, or repository code from NeMo Flow to NeMo Relay across Python, Rust, Node.js, Go, C FFI, CLI, configuration, and observability surfaces. license: Apache-2.0 metadata: author: NVIDIA Corporation and Affiliates --- # Migrate From NeMo Flow To NeMo Relay Use this skill when a user has existing NeMo Flow code or documentation and wants it converted to NeMo Relay. Treat the migration as a mechanical rename plus language-specific validation, not a behavior rewrite. Keep compatibility exceptions explicit before applying broad renames. ## Default Workflow 1. Inspect the working tree and identify touched surfaces: Rust, Python, Node.js, Go, C FFI, CLI/config, docs, or integrations. 2. Resolve `SKILL_DIR` to the absolute directory containing this `SKILL.md` and `TARGET_PATH` to the source repository or target project. Run the bundled helper in dry-run mode before editing: `python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" --rename-paths` 3. Review the reported text edits, path renames, and legacy project configuration warnings with the user. Do not migrate project-local `.nemo-flow/config.toml` or `.nemo-flow/plugins.toml` into `.nemo-relay`. Move those settings manually to a supported user or explicit configuration path after review. 4. Obtain explicit confirmation for the resolved target root, then rerun with `--write`, `--rename-paths`, and `--confirm-root "$TARGET_PATH"`. 5. Apply language-specific cleanup for package manager lockfiles, generated artifacts, and public API examples. 6. Search for remaining Flow names and verify the affected language surfaces. ## Mechanical Rename Map - Brand and repository: `NeMo Flow` -> `NeMo Relay`, `NeMo-Flow` -> `NeMo-Relay` - Python: `nemo-flow` -> `nemo-relay`, `nemo_flow` -> `nemo_relay`, `python/nemo_flow` -> `python/nemo_relay` - Rust: `nemo-flow` -> `nemo-relay`, `nemo-flow-adaptive` -> `nemo-relay-adaptive`, `nemo_flow::` -> `nemo_relay::` - Node.js: `nemo-flow-node` -> `nemo-relay-node`, including related entry points such as `/typed`, `/plugin`, `/adaptive`, and `/observability` - Go: `github.com/NVIDIA/NeMo-Flow/go/nemo_flow` -> `github.com/NVIDIA/NeMo-Relay/go/nemo_relay`, package aliases `nemo_flow` -> `nemo_relay`, and source directories `go/nemo_flow` -> `go/nemo_relay` - C FFI: `nemo_flow.h` -> `nemo_relay.h`, `nemo_flow_*` -> `nemo_relay_*`, `NemoFlow*` -> `NemoRelay*`, and `NEMO_FLOW_*` -> `NEMO_RELAY_*` - CLI/config: `nemo-flow` -> `nemo-relay`, `~/.config/nemo-flow` -> `~/.config/nemo-relay`, `NEMO_FLOW_*` -> `NEMO_RELAY_*`, and `x-nemo-flow-*` -> `x-nemo-relay-*`. Do not blindly rename project-local `.nemo-flow/config.toml` or `.nemo-flow/plugins.toml` into `.nemo-relay`; those files require manual migration to a supported user or explicit configuration path. Do not replace bare `flow`, `Flow`, or `FlowError`. Those can be domain words or intentional compatibility names. ## Language Cleanup - **Python**: update `pyproject.toml`, imports, type stubs, integration package paths, extras, and native module names. Regenerate or refresh lockfiles with the user's package workflow after source edits. - **Rust**: update `Cargo.toml` crate names, workspace dependencies, package references, and `use nemo_relay::...` imports. Let Cargo regenerate `Cargo.lock` when dependencies changed. - **Node.js**: update `package.json`, workspace names, package-lock entries, native addon artifact names, and imports from `nemo-relay-node`. Run the package manager to refresh locks. - **Go**: update `go.mod`, import paths, package declarations, aliases, and any local directory layout under `go/nemo_relay`. - **C FFI**: update header includes, exported symbol names, status and callback type names, macro constants, loader paths, and downstream bindings. - **Docs and examples**: update badges, package install commands, repository links, hosted docs URLs, CLI commands, config paths, and integration names. ## Automation Helper Use `$SKILL_DIR/scripts/migrate_from_nemo_flow.py` for first-pass edits. The helper: - runs as a dry run unless `--write` is passed - skips common vendor, build, cache, and generated directories - skips lockfiles unless `--include-lockfiles` is passed - skips symbolic links and credential-bearing dotenv files - detects project-local `.nemo-flow/config.toml` and `.nemo-flow/plugins.toml`, leaves them unchanged, and reports that they require manual migration to a supported user or explicit configuration path - requires the reviewed target root to be repeated with `--confirm-root` before writing, and refuses filesystem-root or home-directory writes - anchors writes and renames to verified directory handles without following symbolic links, and refuses write mode on platforms that cannot provide those guarantees - uses atomic no-replace path renames and exits nonzero when any requested mutation fails - can report or perform path renames with `--rename-paths` - rewrites only explicit NeMo Flow identifiers, package names, repository names, config paths, headers, environment variables, and FFI type prefixes The helper does not classify arbitrary JSON, YAML, TOML, or INI files as secret. Review every configuration file in the dry-run report. If any reported file is unreviewed or credential-bearing, do not use `--write` on that root. Apply the reviewed changes manually and leave secret-bearing files untouched without reading or displaying their values. Set shell-safe absolute paths before invoking the helper. Replace the example values with the resolved skill directory and either the source repository or the user's target project: ```bash SKILL_DIR="/resolved/absolute/path/to/nemo-relay-migrate-from-flow" TARGET_PATH="/resolved/absolute/path/to/target-project" python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" --rename-paths python3 "$SKILL_DIR/scripts/migrate_from_nemo_flow.py" "$TARGET_PATH" \ --write --rename-paths --confirm-root "$TARGET_PATH" ``` Use `--include-lockfiles` only when the user wants lockfiles edited directly; otherwise regenerate them with Cargo, uv/pip, npm, or Go tooling. ## Verification - Search for remaining explicit Flow identifiers: `rg -n "NeMo Flow|NeMo-Flow|nemo_flow|nemo-flow|NEMO_FLOW|NemoFlow|nemo_flow\\.h|nemo_flow_"` - Run targeted tests for every affected language surface. - For Rust changes, run `cargo test` or the repository's Rust test recipe. - For Python changes, run the relevant import check and tests in the target environment. - For Node.js changes, run package install, type checks, and package tests. - For Go changes, run `go test ./...` from the updated module. - For docs-only migrations, build or link-check docs if the site navigation, install commands, or API references changed. ## Related Skills - `nemo-relay-get-started` - `nemo-relay-instrument-calls` - `nemo-relay-debug-runtime-integration`
© NVIDIA Corporation and Affiliates · Apache-2.0 · NVIDIA/skills