# import-model

Скилл ведёт агента через порт архитектуры из Hugging Face в MAX: разбор конфига, реализация слоёв, проверка против эталона.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 установок · ★ 206
- Автор: modular
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/modular/skills/tree/HEAD/import-model/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/import-model

## Что делает

Скилл включается, когда нужно завести новую архитектуру в MAX по идентификатору модели с Hugging Face. Агент сначала читает `config.json` и код `modeling_<type>.py`, потом ищет похожую архитектуру-донора среди ModuleV3 и строит по её образцу. Каждый слой пишется как подкласс `Module` из `max.experimental.nn` с методом `forward()` над `Tensor`, операции берутся из `max.experimental.functional`.

Работа разбита на три фазы: планирование, реализация, проверка. Переходы между ними закрыты гейтами — например, пока не пройдены критерии завершения из `implement-graph.md`, скрипты проверки запускать бессмысленно, потому что `<slug>.py` всё ещё крутит архитектуру донора и логиты не сойдутся. Вспомогательные скрипты лежат в `scripts/` и вызываются через `pixi run python scripts/import_model.py …`: `inspect`, `scaffold`, `check-walls`, `gates`, `compare`.

Нужен pixi-окружение с установленным MAX, доступ к Hugging Face Hub и GPU для запуска и сверки. Все команды идут через `pixi run`, а не через голые `python` и `max` из PATH. Если сервер поднимается, но выдаёт бессмыслицу или расходится с эталоном, скилл отправляет искать расхождение через `debug-model`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add modular/skills --skill import-model -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/import-model/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/import-model/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add modular/skills --skill import-model -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/import-model/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add modular/skills --skill import-model -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/import-model/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install modular/skills import-model
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/import-model/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add modular/skills --skill import-model -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/modular/skills --path import-model
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/import-model/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add modular/skills --skill import-model -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/modular/skills/tree/HEAD/import-model/SKILL.md

## Когда брать
- перенести архитектуру из Hugging Face в MAX по её model ID
- найти подходящую архитектуру-донора среди ModuleV3
- собрать слои модели на `max.experimental.nn`
- проверить логиты порта против эталона Hugging Face
- отсеять архитектуры, которые MAX уже поддерживает нативно

## Примеры запросов агенту
- Импортируй модель Qwen/Qwen3-8B в MAX
- Добавь эту архитектуру в MAX, начни с донора olmo3
- Сервер работает, но выдаёт бессмыслицу — запусти debug-model

## Похожие
- [deepstream-import-vision-model](https://affpapa.org/nevibecode/skills/deepstream-import-vision-model.md) — скилл · 2300 установок
- [hugging-science](https://affpapa.org/nevibecode/skills/hugging-science.md) — скилл · 1800 установок
- [qianwen-model-selector](https://affpapa.org/nevibecode/skills/qianwen-model-selector.md) — скилл · 5500 установок
- [pixijs-rendering](https://affpapa.org/nevibecode/skills/pixijs-rendering.md) — скилл · 5400 установок
- [import-infrastructure-as-code](https://affpapa.org/nevibecode/skills/import-infrastructure-as-code.md) — скилл · 6900 установок
- [nemo-automodel-model-onboarding](https://affpapa.org/nevibecode/skills/nemo-automodel-model-onboarding.md) — скилл · 1900 установок

Из того же набора: [modular/skills](https://affpapa.org/nevibecode/by/modular/skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md